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PREFACE 


MANUAL OBJECTIVES 


The RSX-11M System Generation and Management Guide is for use in 
generating the RSX-11M operating system. This guide provides 


information on how to generate an RSX-11M system tailored to a 
particular installation's hardware configuration and application 
requirements. 


INTENDED AUDIENCE 


System generation is a fairly complicated process. To fully 
understand what is taking place, readers should be familiar with 
RSX-11M and its component tasks. This guide is directed toward system 
managers (those responsible for tailoring and maintaining installation 
specific RSX-11M systems. 


STRUCTURE OF THIS DOCUMENT 

First, read Chapters 1, 2, and part of 3. Then follow the specific 
instructions in Chapter 3. For complete details on the Phases of 
system generation, read Chapters 5, 7, and 9. 

Chapter 1 contains an overview of the system generation process. It 
acquaints you with the various phases involved in producing a tailored 
system. 


Chapter 2 describes the distribution kits and supplies methods for 
copying the media. 


Chapter 3 provides information on preparing the host system and on 
initiating system generation. 


Chapter 4 provides a summary of the Phase I questions. 

Chapter 5 provides complete details for the Phase I questions. 

Chapter 6 provides a summary of the Phase II questions. 

Chapter 7 provides complete details for the Phase II questions. 
Chapter 8 describes the commands and operation of the Virtual Monitor 


Console Routine (VMR), which initializes the target system in the 
final stage of system generation. 


Chapter 9 describes the optional phase of system generation, Phase 
IIlI. 


Chapter 10 describes the means of confirming that the system 
generation process wasS a success. 


Chapter 11 supplies an interpretation of the system generation error 
messages. ¢ 


Note that Chapters 5 and 7 conclude with details of an actual system 
generation (Chapter 5 contains Phase I, Chapter 7 contains Phase II). 


Appendix A defines the symbols of a saved answer file. 
Appendix B describes the system display task RMDEMO. 


Appendix C describes the Console Output Task (COT) and defines COT 
commands. 


Appendix D describes the queue manager. 


Appendix E describes the I/O Exerciser (IOX) and defines the I0OX ar 
commands. ae: 


Appendix F describes RSX-11M system conventions. 


Appendix G is a listing that describes the means of building a 4K FCS 
resident library. 


Appendix H describes how to use support for DEC supplied Help files. 


Appendix I details hardware bootstrap ROMs. 


ASSOCIATED DOCUMENTS 


The RSX-11M Documentation Directory briefly describes all the manuals 
in the RSX-1IM documentation set and provides a brief synopsis of each 
manual's contents. The following lists the manuals most closely 
allied to the purposes of this guide: 


RSX-11M/M-PLUS Executive Reference Manual 


RSX-11M/M-PLUS MCR Operations Manual 
RSX-l1M/M-PLUS I/O Drivers Reference Manual 


RSX-11M/M-PLUS Task Builder Manual 


ae 


CHAPTER 1 


INTRODUCTION 


The system generation process, SYSGEN, defines a user RSX-11M 
operating system tailored to meet a specific PDP-11 configuration. 
SYSGEN provides the flexibility to generate an RSX-11M system that 
fits the many variations of the hardware configuration as well as the 
software elements. 


This chapter provides an introduction that helps you tailor RSX-11M to 
meet your hardware and software needs. 


1.1 OVERVIEW OF SYSTEM GENERATION 


The system generation process consists of logical steps that 
ultimately produce an RSX-11M system. Figure 1-1 summarizes these 
steps from preparation and planning, invoking the SYSGEN command 
files, creating the tailored system, and placing the system on a 
target media. 


1.1.1 Preparing for SYSGEN 


First, backup your RSX-11M distribution kit. and become familiar with 
the baseline system. The backup copy insures against destruction of 
the data on the kit and provides a base for updates to the operating 
system that you may receive in the future. The baseline system 
controls the system resources during system generation. 


Chapter 2 provides information about the distribution kits and how to 


copy the kits to a backup volume. Chapter 2 also describes the 
RSX-11M baseline system. 


1.1.2 The System Generation Command Files 

RSX-11M indirect command files control system generation. These 
command files are collectively known as SYSGEN. The SYSGEN command 
files: 


e Permit you to define the features to be included in (or 
excluded from) your system 


e Perform MACRO-11 and Task Builder processing to produce an 
executable image of the system 


e Define the system memory requirements 
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Backup Backup 


or 


Tape Volume Disk Volume 


. Plan for system generation 
by reading documentation 
and setting up your 

hardware configuration. 


O, 
= 


Distribution Kit 


. Set.up for system 

generation: 

A. Copy the distribution 
kit. 

B. Bootstrap the baseline 
system into processor 
memory. 


Processor Memory 


Baseline 
ES RSX11M.SYS 


PDP-11 and Peripherals 


. Define your system by 


@ [200,200] SYSGEN.CMD answering questions in 


‘ SYSGEN Phase |: 
@ Source Files SY: Enea 
A. Invoke SYSGEN. 
foe Files 
B. Answer questions. — : iar 
® Command Files ource Files 
. eae 5 C. Assemble the executive. Pe eee 
‘ gE 
eae Files 


@ Object Files 


. Create a bootable image 
of your system in SYSGEN 
Phase II: 

A. Invoke SYSGEN2. 


@ Command Files 
®@ Object Files a) 


Target Volume 


B. Task build (TKB) the 
Executive device drivers, 
and privileged tasks. 


== RSX11M.TSK 


Command Files 
RSX11M.TSK 


. Install your system 
tasks and set up 
Partitions using VMR. 


== RSX11M.SYS 


| ott fede 


Processor Memory 
RSX11M.SYS 


D. Bootstrap your system 
into processor memory. 


RSX11M.SYS 


0 


Figure 1-1 SYSGEN Steps 
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5. If necessary, create 
executable images of 
UTLOBJ nonpriv.tasks or of 
lab I/O peripherals in 
xxx.CMD SYSGEN Phase III: 
xxx.OBJ — @ Task build nonpriv RSX11M.TSK 
or subsystem object 
module, 


xxx.CMD ie 
RSX11M.TSK - Install these tasks with RSX11M.SYS 
a Executive and other 


system tasks using 
VMR. 


Ca a 6. Ensure that your system 

| runs properly by testing 
= : it with the Installation 

| Verification Procedure. 


UETP = ae 


Figure 1-1 (Cont.) SYSGEN Steps 


SYSGEN executes in three phases or parts. In Phase I, you define’ the 
target configuration and assemble the Executive and device drivers. 
In Phase II, you task build the Executive, device drivers, and 
privileged system tasks. In Phase III, you optionally task build 
nonprivileged tasks. 


When SYSGEN completes processing of Phase I, it has produced object 
and command files to be used as input to SYSGEN Phase II. Upon 
completing Phase II, SYSGEN has produced a system image, complete with 
loadable drivers and privileged tasks. You can then, if necessary, 
continue with Phase III and build (or rebuild) nonprivileged tasks. 


1.2 SYSTEM GENERATION FEATURES 


The system generation dialogue is divided into phases, each phase 
designed to generate a separate section of the system: 


Phase I -- Ask SYSGEN dialogue questions and assemble source files 
for the Executive, device drivers, and, if requested, 
laboratory and industrial I/O subsystems. 


Phase II -- Task Build the Executive, device drivers, and all 
privileged tasks, define partitions for the system image, 
load device drivers, and install tasks. 


Phase III -- Optionally, Task Build unprivileged utilities. 


SYSGEN Phase I is divided into sections. The sections either define 
logical parts of an RSX-11M system or provide control information for 
SYSGEN. The following list shows the sections in SYSGEN Phase I along 
with a description of the function performed in each section. 
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SYSGEN 
Section Function 


Setup Defines for SYSGEN how to use _ saved answers 
(described below) and, in general, allows you to 
specify the way SYSGEN executes. : 


Target Defines for SYSGEN the hardware characteristics of 
your target system. 


Host Specifies whether you are running SYSGEN 
standalone (on the baseline system) or online (on 
a previously generated RSX-11M system) and also 
allows you to specify how you want SYSGEN to 
handle listings and maps. 


Executive Defines the Executive features you want to include 
in your RSX-11M target system. 


Terminal Driver Defines the type of terminal driver you want in 
your target system and the software features 
supported by the driver. 


Peripherals Describes control information for the peripherals 
included in your target system, such as Control 
Status Register (CSR) address and vector addresses 
for the peripherals. 


Assembly Provides you the opportunity to edit executive 
build files or laboratory and I/0 build files 
before assembly of Executive and laboratory 


subsystem source files. 


SYSGEN provides the means to inhibit execution of MCR command lines 


during SYSGEN Phase I. This feature allows you to perform a SYSGEN 
without actually executing the commands that create, delete, assemble, 
or build task images. 


MCR command inhibition permits you to follow a logical path through 
SYSGEN without altering existing files. More importantly it provides 
an excellent opportunity for a user to become familiar with SYSGEN 
before actually performing a full or "live" SYSGEN. 


SYSGEN provides the means to save answers to questions asked during 
SYSGEN Phase I and Phase II. These answers are saved in a file called 
SYSSAVED.DAT. You can use this feature to select options and features 
for multiple target configurations or to vary the options and features 
generated for operating systems to be used on the same processor. 
When used in conjunction with MCR command inhibition, you can trace 
the logical flow of SYSGEN and then use the saved answers to generate 
an actual system. 


Three features permit you to execute SYSGEN Phase I without 
interruption. When used with saved answers, these features allow you 
to generate an RSX-11M operating system unattended. 
These three features are: 

e End-of-Section Breakpoints 


e End-of-Execution Breakpoints 


e End-of-Disk Breakpoints 


4 2 
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1.3 FORMAT OF SYSGEN QUESTIONS 


SYSGEN questions provide a simple means for selecting the features you 
want in your_ system. Based on your’ responses, SYSGEN generates 
various command files that control the assembly and task building of 
your system. 


The following question is an example that shows the form of most 
SYSGEN questions: 


* 2. Have you made a copy of the distribution kit? [Y/N]: 


Each SYSGEN question is preceded by an asterisk and a number. In 
SYSGEN Phase I, there aré seven sections; the questions in each 
section are numbered beginning with question number 1. The number is 
followed by the text of the question. The text of the question is 
followed by a prompt generated by the RSX-11M indirect command file 
processor, in this case [Y/N]:. 


When SYSGEN asks a queStion that requires a number aS a response,’ the 
indirect command file processor generates a prompt that specifies the 
defaults and appropriate ranges or options, for example: 


* 35. Number of preallocated QIO packets [D R:0.-15. D:5]: 


The character D following the bracket indicates that the following 
numbers are decimal. R: specifies the range of numbers you can 
enter, in this case from 0 through 15. D: following the range 
specifies the default value SYSGEN uses when you enter only a carriage 
return. 


SYSGEN also asks questions that require ASCII strings as responses: 
* 50. Memory dump device (ddu:) [D: NL:][S]: 


In this case, the character D following the open bracket indicates the 
default. [S]: specifies that an ASCII string response is required. 


Where there are exceptions to these general rules, SYSGEN displays 
prompts to explain how to answer questions. 


When you answer a question with an incorrect value, SYSGEN displays a 
message that describes the error and suggests a procedure to correct 
the problem. 


Error messages are listed alphabetically in Chapter ll. 


1.4 LOGICAL FLOW OF SYSGEN QUESTIONS 


As described above, questions in SYSGEN sections are numbered. 
However, SYSGEN never asks all questions; the questions asked are 
based on the response to previous questions. 


SYSGEN includes some features automatically when you select certain 
options and prints a message to inform you of their inclusion. More 
importantly, when you select an option that requires an option that 
you excluded, SYSGEN automatically includes the excluded option and 
informs you. 
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If you request DBMS support in Executive question l, SYSGEN 
automatically includes Files-1l1l1 support (which would ordinarily be 
asked for in Exective question 2) and displays a message specifying 
that Files-11 support is being included: 


* 1. Will DBMS-11 be used [Y/N] :Y 
Files-ll ACP support will be included 


If you had not selected DBMS, SYSGEN would have asked Executive 
question 2: 


* 1. Will DBMS-11 be used [Y/N]:N 
* 2. FILES-11 ACP [Y/N] :Y 


1.5 INVOKING THE SYSGEN COMMAND FILES 


As described above, system generation is controlled by command files 
known, collectively, as SYSGEN. There is one command file to control 
each phase of SYSGEN: 


SYSGEN.CMD Controls execution of SYSGEN Phase I 
SYSGEN2.CMD Controls execution of SYSGEN Phase II 
SYSGEN3.CMD Controls execution of SYSGEN Phase III 


You invoke each of these as you would invoke any RSX-11M indirect 
command file: 


@filename 


‘where @ invokes the RSX-11M indirect command file processor and 
filename specifies the filename of the command file. You need not 
specify the filetype .CMD when you execute these files. 


When each indirect command file completes execution, it generates’ the 
prompt: 


@<EOF> 


This prompt indicates that a SYSGEN phase has completed execution. If 
you want to execute the next Phase, you must invoke it explicitly. 


As explained above, each of the three main SYSGEN command files must 
be explicitly invoked. However, SYSGEN.CMD (the control file for 
Phase I) invokes secondary control files, as shown in Figure 1-2. 


SYSGEN invokes other command files depending on the type of requests 
you make during the SYSGEN dialogue. These secondary command files 
all have the prefix SGN in their filenames rather than the SYS prefix 
used in the major command files. 


SGNEXEC and SGNPER are invoked when you specify that you want to 


answer executive and peripherals questions. SGNICIS or SGNIP is 
called when you specify that you have laboratory or I/0 subsystem 
peripherals in your configuration. SGNTT is invoked when you are 


answering questions that define terminal driver characteristics. 


~~ 


ky 


s, 
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@SYSGEN @SYSGEN2 @SYSGEN3 


SYSGEN.CMD SYSGEN2.CMD SYSGEN3.CMD 


Li. 


SGNEXEC.CMD SGNPER.CMD 


CAIN 


SGNICIS.CMD = SGNIP.CMD SGNTT.CMD 


Figure 1-2 SYSGEN Command Files and How They Interrelate 


CHAPTER 2 


SETTING UP FOR SYSTEM GENERATION 


This chapter provides information on the following topics: 
e System generation environments 
e Bootstrapping programs into processor memory 
@e RSX-11M distribution kit and baseline system 


e Backing up the distribution kit and bootstrapping the baseline 
system 


e Startup Display Sequence 


2.1 SYSTEM GENERATION ENVIRONMENTS 


When you generate RSX-11M, an operating system controls the processor. 
In an online environment, you are generating RSX-11M under control of 
an operating system that has already been tailored to your 
hardware/software environment. When you must generate RSX-11M without 
such an operating system, you must use the RSX-11M baseline system. 


In general, if you are generating RSX-11M in an online environment, 
you need not go through many of the setup procedures described below. 


If you are generating a new system online, you should protect existing 
files and data; SYSGEN creates and deletes files and uses many UICs 
during its execution. You can protect existing files and data by 
isolating devices used by SYSGEN from system devices. For example, if 
your system device is normally DBO: and you have another unit 
available, run SYSGEN using DBl: (for example, ASN DB1:=SY:). 


If you are generating RSX-11M on the baseline system, you must’ follow 
the procedures described in this chapter. 


2.2 BOOTSTRAPPING PROGRAMS INTO PROCESSOR MEMORY 


Your PDP-11 processor must have a control program resident in its 
memory before you can use the hardware resources. For the RSX-11M 
system generation, two systems are used to control system resources: 
the Disk Save and Compress (DSC) standalone system and the RSX-11M 
baseline system. DSC is discussed briefly later in this chapter and 
in detail in the RSX-11 Utilities Manual. The following sections 
discuss the RSX-11M baseline system. 
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These systems are loaded into memory using hardware bootstrap routines 
in PDP-11 Read-Only Memory (ROM). Ensure that you know which of the 
bootstrap ROMs is in your processor. 


The keys on the console panel of your processor provide control 
functions you can use _ to bootstrap control programs into processor 
Memory. These console functions are controlled by switches which vary 
in appearance on different processors. Refer to the Processor 
Handbook for your processor for explanations of these functions. 


2.3 THE RSX-11M SYSTEM GENERATION DISTRIBUTION KIT 


RSX-11M distribution kits are the tape or disk media that contain the 
source, object, task, and command files you need to build your RSX-11M 
system. 


Regardless of whether your kit is a disk kit or a tape kit, RSX-11M 
system generation is always done using disks; if you receive a tape 
distribution kit, the tape(s) contains images for a particular type of 
disk kit. 


There are three types of kits: the dual RKO5 kit, the RLO1l kit, and 
the big disk kit. The term "big disk kit" refers to the type of kit 
on which the entire distribution kit can be stored on a_ single disk 
volume. Big disk media can be one of the following: 


RK06/RKO7 
RMO2/RM03 
RPO 2/RP03 
RP04/RP05/RP06 


This section describes the types of RSX-11M distribution kits, the 
contents of each kit, and how to backup a kit. 


2.3.1 Types Of Distribution Kits 


RSX-11M is distributed on either disk or tape. Whether your kit is on 
disk or tape, create a backup copy on disk before you try to generate 
your system. 


The backup of the distribution kit provides a base against which you 
can update your system when you receive patches from DEC. Also, the 
backup provides you with a spare volume with which to retry SYSGEN in 
case you destroy important files or otherwise make your system 
unusable. 


2.3.1.1 Disk Distribution Kits - Disk kits are distributed on three 
types of disk media. The following list shows the disk type and the 
number of disks in the kit: 


Type of Number of 
Kit Disks 
RKO5 6 

RLO1 4 

Big Disk Kit (the RKO6 or RKO7 only) 1 


For big disk kits, only RKO6 or RKO7 disks are physically distributed, 
other big disk kits are furnished on magtape. 
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2.3.1.2 Tape Distribution Kits - RSX-11M is distributed on 6 types of 
tape kits. Each tape must be copied to disk using DSC before 
performing the SYSGEN; each tape contains DSC images for the 
appropriate type of disk. After you copy the tape to disk, the disk 
can be booted. All tapes are 9-track tapes. The following list shows 
the type of disk to which the tape must be copied, the number of tapes 
in the kit, the tape length, and the tape density before generating 
your system. 


Type of Number of Tape Tape 
Disk Tapes Length (feet) Density (bpi) 
RKO5 6 600 800 
RLO1/RLO2 2 2400 800 
RKO6/RK07 4 600 800 
RMO 2/RM03 1 2400 800 
RMO 2/RMO3 1 2400 1600 
RP02/03 1 2400 800 
RP04/05/06 1 2400 800 
RP0 4/05/06 1 2400 1600 


2.3.2 Contents of the RSX-11M Release Kit 


There may be several disks used during SYSGEN, depending on which kit 
you have. Each disk has a volume label that describes the contents of 
the disk. The following sections describe the contents of all three 
types of kits in terms of the contents of the volume in the RKOS kit. 


2.3.2.1 Volumes on the RKOS5S Distribution Kit - The following list 
shows the volume name of each of the disks in the RKO5 distribution 
kit, along with a brief description of the files on the volume. 


RSXM26 This disk contains the files that comprise’ the 
baseline system; this disk also contains various 
standalone systems used during system generation, 
for example, DSCS8, DSCS16, and PRESRV. 


EXCSRC This disk contains the source files for the 
RSX-11M Executive; this disk also contains other 
files used by SYSGEN, including MAC and_ BIGMAC. 
Also included on this volume are standalone 
versions of DSC: DSCS8 and DSCS16. This volume 
contains the Backup and Restore utility (BRU) 
files and the files to produce Help text files. 
For information on the help text files, see 
Appendix H. 


DRVSRC This volume contains the source files for the 
drivers. This volume also contains the K-~series 
routines. 

MCRSRC This disk contains the source files for MCR, the 


Shuffler, broadcast (BRO), console output task 
(COT), and the account file maintenance program 
(ACNT). 


PRVOBJ This disk contains the object files for RSX-11M 
privileged tasks, as well as .ODL and .OLB files. 


UTLOBJ This disk contains the object files for the 
RSX-11M utilities and nonprivileged tasks. 
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2.3.2.2 Volumes on the RLO1 Distribution Kit - The following list 
Shows the volume name of each of the disks in the distribution kit, 
along with a brief description of the contents of the volume. 


RSXM26 This disk contains the files that comprise the 
baseline system 


MAPSRC Contains all the files required to build mapped ~ 


systems. The files in this volume correspond to 
the following volumes in the RKOS kit: 


EXCSRC 

DRVSRC 

PRVOBJ 
All task files are in UIC [1,54] for mapped 
systems. 

UNMSRC Contains all the files required to build unmapped 
systems. The files in this volume correspond to 
the same volumes as in MAPSRC, above. However, 
task files for unmapped systems’ reside in UIC 
[1,50]. 

RLUTIL Contains files corresponding to the files in the 
following volumes on the RKOS kit: 

; UTLOBJ 
MCRSRC 


This disk also contains the Backup and Restore 
utility (BRU) files and the files to produce Help 
text files. For information on the help text 
files, see Appendix H. 


2.3.2.3 Volume on Big Disk Kits - The volume name of the disk for 
large disk kits is RSXM26. This volume contains all the source, 
object and other files required for system generation. 


2.3.3 Standalone DSC 


All distribution kits include standalone versions of the Disk Save and 
Compress (DSC) Utility. DSC is used to create backup copies of the 
distribution kit. 

There are two versions of the standalone DSC utility, DSCS8 and 
Dscsl6. DSCS8 is used with 800 BPI (and 1600 BPI) tape devices and 
DSCS16 is used with 1600 BPI tape devices only. 


Disk kits include copies of both versions in UIC [1,51]. 


Included in each tape kit is a 600-foot, 9-track 800 BPI magnetic tape 
that contains a hardware bootable, standalone version of the Disk Save 
and Compress Utility (DSCS8). Use the DSC tape to copy tape kits _ to 
disk. 
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2.3.4 The RSX-11M Baseline System 


If you do not have an RSX-11M operating system for your host computer 
(your host computer is-the computer on which you are performing the 
system generation), you need an operating system to control the host's 
resources while you generate an RSX-11M operating system. DEC 
provides the RSX-11M baseline system for this purpose. 


During SYSGEN, many files are created, installed and removed, then 
deleted. Also, these files are contained in many UICs in order to 
separate one type of file from another. Among other reasons, the 
tasks on the baseline system are used to make these types of file 
manipulation functions possible. 


Execution of baseline system tasks is controlled by MCR (the RSX-11M 
Monitor Console Routine). 


The baseline system is an RSX-11M operating system that comprises only 
those software tools you need to generate amore complex system 
tailored to your specific configuration. 


2.4 BACKING UP YOUR DISTRIBUTION KIT AND BOOTSTRAPPING THE BASELINE SYSTEM 


When you receive the RSX-11M distribution kit, you should make a 
backup copy of the kit to ensure against accidents to the files and 
data on the kit and to provide a base for system updates. 


This section describes the procedures for backing up tape and disk 
distribution media. 


2.4.1 Backing Up Tape Distribution Media 


When you receive tape distribution media, use the hardware bootable 
DSC tape to copy the tape media to disk because the system generation 
program requires disk volumes for its processing. Once you copy the 
distribution media from tape, the tape is your backup copy of the kit. 


The procedure for copying from tape to disk and bootstrapping the 
baseline system is shown in Figure 2-1. 


Step 1 in Figure 2-1 is bootstrapping the standalone version of the 
Disk Save and Compress Utility (DSC) into processor memory. 
DSC provides the functions required to copy the RSX-11M 
distribution media. (For a complete description of DSC 
functions, refer to the RSX-1ll Utilities Manual.) 


To bootstrap DSC, mount the DSC tape you receive with the 
distribution kit and the disk to which you are writing, and 
follow the hardware bootstrap procedures for your particular 
bootstrap ROM. The PDP-11 hardware bootstrap routine 
bootstraps the standalone version of DSC into processor memory 
and gives DSC control of the_ system. DSC displays’ the 
following line when it is ready: 


RSX11S V2.2 BL26 DISK SAVE AND COMPRESS UTILITY V3.0 
DSCS8> 


You can then enter the DSC command lines to create disk copies 
of the distribution media. 
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Figure 2-1 Copying Tape Distribution Kits 


Step 2 in Figure 2-1 is copying the tape distribution media to disk 
using DSC. The following is the general format for entering 
DSC command lines to copy from tape to disk: 


DSC>outdevice:=indevice: 


where DSC> is the DSC prompt, outdevice: specifies the disk 
device to which DSC is copying data, and indevice: is the tape 
input device with the tape distribution media mounted. 


When the tape media is copied to disk, you can hardware 
bootstrap the baseline system and invoke SYSGEN. 


Step 3 in Figure 2-1 is to hardware bootstrap the RSX-11M baseline 
system into processor memory to control the system resources 
while SYSGEN is executing. 


To bootstrap the baseline system, mount the disk on which’ the 
baseline system resides, and follow the hardware bootstrap 
procedures for your particular bootstrap ROM. The PDP-1l 
hardware bootstrap routine bootstraps the baseline system into 
processor memory, giving control of the system to the baseline 
system. Section 2.5 describes the startup display sequence. 


Step 4 in Figure 2-1 is to verify the integrity of the disks you are 
using for system generation. Use the File Structure 
Verification Utility (VFY) to ensure the integrity of these 
disks. (The RSX-11 Utilities Manual provides details of all 
the functions performed by VFY.) 


Use the following command lines to ensure the integrity of a 
disk: 


>RUN SVFY 
VFY>/RC 
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7RC is the Read Check switch. This switch reads from the disk 
ensuring that each block on the disk that is allocated to a 
file can be read. If VFY reports that it cannot read a_ block, 
call your local DIGITAL Software Support Specialist for 
assistance. 


When you complete this procedure, you can invoke the SYSGEN procedure, 
as described in Chapter 3. 


2.4.2 Backing Up Disk Distribution Media 


You can back up disk distribution media to either disk or tape backup 
volumes. Figure 2-2 outlines the procedure for creating a backup copy 
of disk distribution media. 


Distribution Kit 


RSX-1 1M Processor Memory 

Baseline 1. Hardware bootstrap the Baseline 

System RSX-11M baseline system RSX11M.SYS System 
into processor memory. 

BOOT 


2. Install the software 
bootstrap routine using 
the MCR INSTALL 
command: 


Distribution Kit INS $B0O 


Sones 


3. Software bootstrap 
standalone DSC into 
processor memory using 
the MCR Boot command: 
BOO [1,51] DSC58 


Processor Memory 
Standalone 


DSC 


Distribution Kit 


a 


Backup Volume 


4. Copy your distribution 
kit using the standalone 
DSC system. 


5. Verify your system disks 


using VFY. 
Backup Volume 


= 


Processor Memory 


RSX11M.SYS 


6. Hardware bootstrap the 
RSX-11M baseline system 
into processor memory. 


Baseline 
System 
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Figure 2-2 Copying Disk Distribution Kits 
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in Figure 2-2 is to hardware bootstrap the RSX-11M baseline 
system into processor memory to control the system resources 
while SYSGEN is executing. 


To bootstrap the baseline system, mount the disk on which’ the 
baseline system resides, and follow the hardware bootstrap 
procedures for your particular bootstrap ROM. The PDP-11 
hardware bootstrap routine bootstraps the baseline system into 
processor memory, giving control of the system to the baseline 
system. Section 2.5 describes the startup display sequence. 


in Figure 2-2 is to install the MCR BOOT command (the _ software 
bootstrap routine) into memory. Using the BOOT command, you 
can bootstrap the standalone version of DSC into processor 
memory. You then use DSC to copy the kit. To install BOOT, 
enter the command line: 


>INSTALL $BOO 


The software bootstrap routine has the same effect as_ the 
hardware bootstrap routine, that is, it bootstraps DSC into 
processor memory and gives DSC control of the system. 


in Figure 2-2 is bootstrapping the standalone version of the 
Disk Save and Compress Utility (DSC) into processor memory. 
DSC provides the functions required to back up and restore data 
on the RSX-11M distribution media. (For a complete description 
of DSC functions, refer to the RSX-11 Utilities Manual.) 


To bootstrap DSC, using the software Boot task, enter’ the 
command BOO [1,51]DSCS8. The software bootstrap routine 
bootstraps the standalone version of DSC into processor memory 
and gives DSC control of the system. DSC displays’ the 
following line when it is ready: 


RSX11S V2.2 BL26 DISK SAVE AND COMPRESS UTILITY V3.0 
DSCS8> 


You can then enter the command lines to create copies of the 
distribution media. 


in Figure 2-2 is copying the disk distribution media to disk 
using DSC. The following is the general format for entering 
DSC command lines to copy from disk to disk: 


DSC>outdevice:=indevice: 


where DSC> is the DSC prompt, outdevice: specifies the device 
to which DSC is copying data, and indevice: is the input 
device with the distribution media mounted. 


When the media is copied, you can use the disk copy of the 
media to bootstrap the baseline system and invoke SYSGEN, 


in Figure 2-2 is to verify the integrity of the disks you are 
using for system generation. Use the File Structure 
Verification Utility (VFY) to ensure the integrity of these 
disks. (The RSX-11 Utilities Manual provides details of all 
the functions performed by VFY.) 


Use the following command line to ensure the integrity of a 
disk: 


>RUN SVFY 
VFY> /RC 
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7RC is the Read Check switch. This switch reads from the disk 
ensuring that each block on the disk that is allocated to a 
file can be read. If VFY reports that it cannot read a_ block, 


call your local DIGITAL Software Support Specialist for 
assistance, 


in Figure 2-2 is to hardware bootstrap the RSX-11M baseline 
system into processor memory to control the system resources 
while SYSGEN is executing. 


To bootstrap the baseline system, mount the disk on which the 
baseline system resides, and follow the hardware bootstrap 
procedure for your particular bootstrap ROM. The PDP-11 
hardware bootstrap routine bootstraps the baseline system into 
processor memory, giving control of the system to the baseline 
system. Section 2.5 describes the startup display sequence. 


When you complete this procedure, you can invoke the SYSGEN procedure, 
as described in Chapter 3. 


2.5 START-UP DISPLAY SEQUENCE 


I£ the 
device 
appears 


De 


RSX-11M system being bootstrapped was built with a different 
configuration than the current host, a series of display lines 
on the console in the form: 

vice ddnn: NOT IN CONFIGURATION* 

Where: 


dd=device NAME. 
nn=unit NUMBER. 


(Devices not in the configuration are declared OFFLINE and the display 


OFFLINE 
Devices 


Then th 


RS 


is appended to these devices as part of the output of the MCR 
command). 


e system displays: 


X-11M <vers-num><base-level><mem-siz> [mapped] 


>RED DDNN:=SY0: 
>RED ddnn:=LBO: 


>M 
>@ 


OU ddnn:volname 
{1,2] STARTUP 
Where: 
<vers-num> ~ The release version number (for example, 
release 3.2 of RSX-11M is V3.2). 
<base-level> - The software development group at DIGITAL 


periodically brings together new versions 
of the software under development. 
Internal groups may use this software to 
ensure correct operation and to build new 


software. These development milestones 
are called base levels. For example, 
release 3.2 of RSX-11M is’ base level 
BL26. 
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<mem-siz> - The memory size (in the form of nnnk) of 
the machine on which the system was 
bootstrapped. 

[mapped] - Mapped is displayed for systems built to 
use the Memory Management Unit. 

ddnn: - Device name and unit number of the boot ' 
device. 

volname - The name of the volume that contains’ the 


booted system. 


[1,2] STARTUP - The file specifier for the indirect = 
command file, which is invoked 
automatically at bootstrap time and which 
contains user commands for initializing 
the bootstrapped system. 


The system is now ready for operation. The RED and MOU displays are 
internally generated Redirect and Mount commands. The Redirect 
command establishes the load device as the system and library devices ma 
SY: and LB:, and the Mount command mounts the load device as a ee ee 
Files-1l1 volume. 


CHAPTER 3 


GETTING STARTED 


This chapter describes the pre-processing steps which prepare the host 
system for the system generation procedure, 


Each type of distribution kit is described in a separate’ section. 
Read the section that pertains to your kit as follows: 


e Big disk distribution kits, Section 3.1 
@e Dual RKOS5 distribution kits, Section 3.2 
@e RLO1 distribution kits, Section 3.3 


To perform a SYSGEN, you must be privileged. Privileged status 
insures that the command files can access as well as create and delete 
files in various UFDs. 


To perform a PREPGEN, privileged status is not required; a PREPGEN 
does not create or delete files (if requested, a PREPGEN creates the 
file SYSSAVED.DAT). Also, a PREPGEN uses the UFD that corresponds’ to 
the default UIC of the terminal to find command files and create 
SYSSAVED.DAT. 


NOTE 


If you wish to direct listings or maps 
to a device other than SY:, LB:, or TI:, 
you should load the driver and then 
Mount the device before you begin. the 
system generation process. 


3.1 BIG DISK DISTRIBUTION KITS 


If you have a previously generated RSX-11M version 3.2 system, read 
Section 3.1.1. 


If you do not have a running RSX-11M version 3.2 system available, 
read Section 3.1.2. 
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3.1.1 Online SYSGENs and PREPGENS 


The following lists the pre-processing steps to perform an_ online 
‘SYSGEN or PREPGEN: 


1. Mount the baseline system disk. For example: 
>MOU DB2:RSXM26 


2. Assign the baseline system disk to the pseudo device SY:. 
For example: 


>ASN DB2:=SY: 


3. The system generation command files require an indirect 
command file processor with extended symbol table space. For 
mapped systems, this is a 12K-word version (BIGIND). For 
unmapped systems, this is a 14K-word version (BIGIND). If 
the running system contains the 8K-word indirect (without 
symbol table space extensions), remove the task AT. and 
install BIGIND specifying a priority of 10(10). For example: 


>REM ...AT. 
>INS SBIGIND/PRI=10. 


4. If performing a SYSGEN, set the UIC to [200,200]. For 
example: 


>SET /UIC=[200,200] 
This is not required to perform a PREPGEN. 
5. Initiate SYSGEN Phase I. For example: 
>@SYSGEN 


6. For a summary of the Phase I questions, read Chapter 4. For 
a detailed description of Phase I questions, read Chapter 5. 


3.1.2 Standalone SYSGENsS and PREPGENS 


The following lists the pre-processing steps to perform a SYSGEN or 
PREPGEN using the baseline system. 


1. Hardware bootstrap the system using the device that contains 
the baseline system disk (RSXM26) as the boot device. This 
will bring up the unmapped baseline system. If the host 
system includes the memory management unit and you are 
generating a mapped system, software boot the mapped baseline 
system. For example: 


>INS SBOO 
>BOO [1,54]RSX11M 


2. The system generation command files require an indirect 
command file processor with extended symbol table space. For 
mapped systems, this is a 12K-word version (BIGIND). For 
unmapped systems, this is a 14K-word version (BIGIND). The 
baseline system contains the 8K-word version, which lacks 
sufficient symbol table space. Remove the task AT. and 
install BIGIND specifying a priority of 10(10). For example: 


>REM ...AT. 
>INS SBIGIND/PRI=10. 
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3. Initiate SYSGEN Phase I. For example: 
>@SYSGEN 


4. For a summary of the Phase I questions, read Chapter 4. For 
a detailed description of Phase I questions, read Chapter 5. 


3.2 DUAL RKOS DISTRIBUTION KITS 


The dual RKO5 distribution kit requires two RKO5 drives. When SYSGEN 
completes processing of the Executive source disk (EXCSRC), you must 
replace the disk with the driver source disk (DRVSRC) so that SYSGEN 
can access’ the driver source files. This is known as an end-of-disk 
breakpoint (EOD). Note that if your host configuration includes more 
than two RKO5 drives, you can override these breakpoints. See Chapter 
5 for details. 


3.2.1 Online SYSGENS and PREPGENS 


The following lists the pre-processing steps to perform an _ online 
SYSGEN or PREPGEN: 


1. Mount the baseline system disk. For example: 
>MOU DK:RSXM26 


2. Assign the baseline system disk to the pseudo device SY:. 
For example: 


>ASN DK:=SY: 


3. The system generation command files require an indirect 
command file processor with extended symbol table space. For 
mapped systems, this is a 12K-word version (BIGIND). For 
unmapped systems, this is a 14K-word version (BIGIND). If 
the running system contains the 8K-word version (without 
symbol table space extensions), remove the task AT. and 
install BIGIND specifying a priority of 10(10). For example: 


>REM ...AT. 
>INS SBIGIND/PRI=10. 


4. If performing a SYSGEN, set the UIC to [200,200]. For 
example: 


>SET /UIC=[200,200] 
This is not required to perform a PREPGEN. 


5. If performing a PREPGEN, mount the Executive source disk and 
assign this device to the pseudo device LB:. For example: 


>MOU DK1:EXCSRC 
>ASN DK1:=LB: 


This is not required to perform a SYSGEN; a SYSGEN 
automatically issues Mount and Assign commands for the device 
that contains the Executive source files. 
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6. Initiate SYSGEN Phase I. For example: 
>@SYSGEN 


7. #j§For a summary of the Phase I questions, read Chapter 4. For 
a detailed description of Phase I questions, read Chapter 5. 


3.2.2 Standalone SYSGENsS and PREPGENS 


The following lists the pre-processing steps to perform a SYSGEN or 
PREPGEN uSing the baseline system: 


1. Hardware bootstrap the system using the device that contains 
the baseline system disk (RSXM26) as the boot device. This 
will bring up the unmapped baseline system. If the host 
system includes the memory management unit and you are 
generating a mapped system, software boot the mapped baseline 
system. For example: 


>INS $BOO 
>BOO [1,54]RSX11M 


2. The system generation command files require an indirect 
command file processor with extended symbol table space. For 
mapped systems, this is a 12K-word version (BIGIND). For 
unmapped systems, this is a 14K-word version (BIGIND). The 
baseline system contains the 8K-word version, which lacks 
sufficient symbol table space. Remove the task AT. and 
install BIGIND specifying a priority of 10(10). For example: 


>REM écAT. 
>INS SBIGIND/PRI=10. 


3. If performing a PREPGEN, mount the Executive source disk and 
assign this device to the pseudo device LB:. For example: 


>MOU DK1:EXCSRC 
>ASN DK1:=LB: 


This is not required to perform a_ SYSGEN; a SYSGEN 
automatically issues Mount and Assign commands for the device 
that contains the Executive source files. 


4. Initiate SYSGEN Phase I. For example: 
>@SYSGEN 


5. For a summary of the Phase I questions, read Chapter 4. For 
a detailed description of Phase I questions, read Chapter 5. 


3.3 RLO1 DISTRIBUTION KITS 


The RLO1 distribution kit requires two RLO1 drives to perform a SYSGEN 
or a PREPGEN. However, you can perform a SYSGEN or PREPGEN using a 
single RLO1 provided that you have a secondary storage device. The 
secondary storage device can be a magtape unit or a disk drive of a 
different type. 
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To generate a system using two RLO1l drives, you simply load the 
baseline system disk (RSXM26) and either the mapped source disk 


(MAPSRC) to generate a mapped system or the unmapped source disk 
(UNMSRC) to generate an unmapped system. 


To generate a system uSing a single RLO1l drive, you must copy the 
contents of [11,10] from the mapped or unmapped source disk (MAPSRC 
for mapped target systems, UNMSRC for unmapped target systems) to 
secondary storage. Later, during SYSGEN Phase II, you will copy these 
files from secondary storage onto the baseline disk under [1,24]. 
Note that both the mapped and unmapped source disks contain a bootable 
copy of RSX-11M. Thus, if you are running standalone, you must boot 
the proper disk (MAPSRC for mapped target systems, UNMSRC for unmapped 
target systems), copy [11,10] to secondary storage, and then reboot 
using the baseline system disk. 


If your secondary storage device is a disk drive of a different type 
and the driver is loadable, you can specify this drive as the device 
that contains the Executive sources (obviously, you must first copy 
the mapped or unmapped sources to this drive). 


3.3.1 Online SYSGENs and PREPGENS 


The following lists the pre-processing steps to perform an online 
SYSGEN or PREPGEN: 


1. Mount the baseline system disk. For example: 


>MOU DL:RSXM26 


If you are using a single RLO1 drive, you must first copy the 
contents of [11,10] from the mapped or unmapped source disk 
to secondary storage. 


To generate a mapped system, mount the mapped source disk 
(MAPSRC) and copy the contents of [11,10] to secondary 
Storage. For example: 


>MOU DL:MAPSRC 
>FLX MM:/ZE 
>FLX MM: /DO=DL: [11,10]*.*/RS 


To generate an unmapped system, mount the unmapped source 
disk (UNMSRC) and copy the contents of [11,10] to secondary 
Storage. For example: 


>MOU DL:UNMSRC 
>FLX MM:/ZE 
>FLX MM:DO=DL: [11,10]*.*/RS 


When the copy completes, dismount and unload the mapped or 
unmapped source disk and mount the baseline system disk. For 
example: 

>MOU DL:RSXM26 


2. Assign the baseline system disk to the pseudo device SY:. 
For example: 


>ASN DL:=SYs: 
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The system generation command files require an indirect 
command file processor with extended symbol table space. For 
Mapped systems, this is a 12K-word version (BIGIND). For 
unmapped systems, this is a 14K-word version (BIGIND). If 
the running system contains the 8kK-word indirect (without 
symbol table space extensions), remove the task AT. and 
install BIGIND specifying a priority of 10(10). For example: 


>REM ...AT. 
>INS $BIGIND/PRI=10. 


If performing a SYSGEN, set the UIC to [200,200] For example: 
>SET /UIC=[200,200] 

This is not required to perform a PREPGEN. 

Initiate SYSGEN Phase I. For example: 
>@SYSGEN 


For a summary of the Phase I questions, read Chapter 4. For 
a detailed description of Phase I questions, read Chapter 5. 


3.3.2 Standalone SYSGENsS and PREPGENs 


The following lists the pre-processing steps to perform a SYSGEN or 
PREPGEN using the baseline system: 


l. 


Hardware bootstrap the system uSing the device that contains 
the baseline system disk (RSXM26) as the boot device. This 
will bring up the unmapped baseline system. If the host 
system includes the memory management unit and you are 
generating a mapped system, software boot the mapped baseline 
system. For example: 


>INS S$BOO 
>BOO [1,54]RSX11M 


If you are using a single RLO1 drive, you must first hardware 
bootstrap the mapped or unmapped source disk. Then copy the 
contents of [11,10] to secondary storage. 


To generate a mapped system, hardware bootstrap the system 
using the device that contains the mapped source disk 
(MAPSRC) as the boot device. Then copy the contents of 
{11,10] to secondary storage. For example: 


>FLX MM:/ZE 
>FLX MM: /DO=DL: [11,10]*.*/RS 


To generate an unmapped system, hardware bootstrap the system 
using the device that contains the unmapped source disk 
(UNMSRC) as the boot device. Then copy the contents of 
[11,10] to secondary storage. For example: 


>FLX MM:/ZE 
>FLX MM: /DO=DL: [11,10]*.*/RS 
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When the copy operation completes, halt the system and remove 
the mapped or unmapped source disk from the drive. Then, 
reboot using the baseline system disk. 


The system generation command files require an indirect 
command file processor with extended symbol table space. For 
Mapped systems, this is a 12K-word version (BIGIND). For 
unmapped systems, this is a 14K-word version (BIGIND). The 
baseline system contains the 8K-word version, which lacks 
sufficient symbol table space. Remove the task AT. and 
install BIGIND specifying a priority of 10(10). For example: 


>REM ...AT. 
>INS SBIGIND/PRI=10. 


Initiate SYSGEN Phase I. For example: 
>@SYSGEN 


For a summary of the Phase I questions, read Chapter 4. For 
a detailed description of Phase I questions, read Chapter 5. 


CHAPTER 4 


SUMMARY OF SYSGEN PHASE I QUESTIONS 


This chapter provides summary information for SYSGEN Phase I. The 
chapter is meant to help familiarize you with the SYSGEN questions and 
as reference for when you become familiar with SYSGEN. 


4.1 SUMMARY OF SYSGEN PHASE I SETUP QUESTIONS 


The following list comprises the possible setup questions for SYSGEN 
Phase I. 


Not all of the questions are pertinent; the order of the questions 
depend upon the distribution kit you are using as_ well as the 
responses to the questions. For complete details and the implications 
of your responses, see Chapter 5. 


1. Inhibit MCR command lines (Type <ESC> for explanation) 


An affirmative response permits you to follow the logical flow of 
a specific SYSGEN, without actually executing commands that 
assemble, build, or delete files. The manual refers to this as a 
PREPGEN. 


A negative response indicates that you wish to perform a "live" 
SYSGEN. 


2. Have you made a copy of the distribution kit 


If you are performing a SYSGEN, this question insures that you 
have copied the distribution kit. Following a negative reply, 
SYSGEN exits to allow you to do so. 


3. Use saved or canned answer files for input responses 


This question permits you to use a saved answer file as responses 
to SYSGEN questions. 


4. Undefined answer wakeup 


If you are using a saved answer file, an affirmative response to 
this question instructs SYSGEN to precede necessary questions 
(either a question you did not answer or a question for which a 
saved response does not exist) with a CTRL/G (bell). Thus, 
SYSGEN alerts you when a response is required. 


5. Use saved host configuration 


If you are using a saved answer file, an affirmative response 
indicates that SYSGEN can use your previous host responses. For 
example, you are performing SYSGEN on the same host 
configuration. 
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Use saved peripheral configuration 


If you are using a saved answer file, an affirmative response 
indicates that you do not wish to change the _ peripheral 
configuration. 


Skip end of section (EOS) breakpoints 


If you are using saved answer files, an affirmative response 
permits SYSGEN to continue after each section of Phase I. 


Skip end of execution (EOX) breakpoints 


If you are using a saved answer file, an affirmative response 
instructs SYSGEN to continue after assembly or task build 
operations complete. For example, you are certain that all 
device drivers will assemble correctly. 


Skip end of disk (EOD) breakpoints 


Dual RKO5 kits only. An affirmative response indicates that you 
do not have to change RKO5 disks. For example, you have more 
than two RKO5 drives available (one for the baseline system, one 
for the Executive source files, and one for the device driver 
source files). 


Save responses (i.e.: create SYSSAVED.DAT) 


An affirmative response instructs SYSGEN to create the file 
SYSSAVED.DAT, which can later be used as input to SYSGEN. See 
Chapter 5. 


UIC for SYSSAVED files if not [current UIC] 


If you are using a saved answer file, SYSGEN assumes that the 
file is in the UFD corresponding to the current UIC. Enter a UIC 
to override this default. Also, if you are creating the file 
SYSSAVED.DAT (a YesS response to question 10), SYSGEN will create 
the file in the UFD corresponding to the current UIC. Again, 
enter a UIC to override this default. 


UIC for SYSGEN command files if not [current UIC] 


SYSGEN assumes the command files are in [200,200] for SYSGENs. 
If you have moved them, enter a UIC. 


If you are performing a PREPGEN (a Yes reply to question 1), 
SYSGEN assumes the command files are in the UFD corresponding to 
the current UIC. If they are not, enter a UIC. 


Clean up files from previous GENs 

If you are performing a SYSGEN, disk space becomes critical. An 
affirmative response instructs SYSGEN to delete old and 
unnecessary files created during previous SYSGENS (for example, 
RSXBLD.CMD and RSXASM.CMD). 


Device, when ready, for Executive sources (ddu:)[D: SY:] 
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NOTE 
If you are using the RLO1 or the dual RKO5 distribution 
kit, there is no default response to this question; you 


must enter the device that contains the Executive source 
files, 


For big disk kits, SYSGEN assumes that the Executive source files 
are on SY:. Enter a device specification if not. 
15. Driver source files device (ddu:) 


Dual RKO5 kits only. Enter the device that contains the device 
driver source files. 


2ASN SY:=LB: 
>PIP /FR 


Following the free block display, SYSGEN changes the UIC to [11,10]. 


>SET /UIC=[11,10] 


4.2 SUMMARY OF TARGET AND HOST QUESTIONS 

The SYSGEN Phase I target and host questions ask you to define the 
target and host configurations. Target questions define hardware 
features in your configuration as well as the attached peripheral 
devices. Host questions determine, primarily, how you want to handle 
listings. 


The following list comprises the possible target and host questions 
for SYSGEN Phase I. 


Target 

l. Processor (e.g.: 11/34, LSI-11) 

Enter the target processor type. 
2. Does processor have a switch register 

Enter Yes if the target processor has a switch register. 
3. Generating RSX-11S 

Enter Yes if you wish to generate an RSX-11S system. 
4. Memory size (in K-word blocks) 


Enter the number of K-word blocks of memory for the target 
processor. Note that memory blocks must be a multiple of 4K. 


5. Mapped 


Enter Yes if you are generating a mapped system. Note that a 
mapped system requires a minimum of 24K-words of memory. 


6. Any K-series laboratory devices 


Enter Yes if the target configuration includes the K-series 
laboratory peripheral options. 
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Extended arithmetic element (KE11-A/B EAE) present 
Enter Yes if the target processor contains the PDP-1l EAE option. 
Floating point processor (FP-11) present 


Enter Yes if the target processor includes the floating point 
option. 


Floating instruction set (FIS) present 


Enter Yes if the target configuraton includes the floating 
instruction set processor. 


If using KW11-P as system clock: number of intrps./sec. 

If you are using the KW1l1-P programmable clock as _ the_ system 
clock, enter the number of interrupts per second. Note that the 
number of interrupts must evenly divide into 10,000. 

Line frequency: A-60Hz B-50Hz [D: "A"] 

Enter the line frequency. The default is 60Hz. 

KW11-Y Watchdog timer support 

Enter Yes if the target configuration includes the KW11-Y. 

Memory parity support 

Enter Yes if the target configuration contains parity memory. 


Cache memory 


In conjunction with memory parity Support, cache memory speeds 
main memory operations. Enter Yes if your system includes it. 


Highest interrupt vector (If 0 will be computed) 

SYSGEN automatically computes the highest interrupt vector 
address. Enter a value greater than 400 if you require vector 
space for devices not specified during SYSGEN. 


Devices 


Enter the device mnemonic for all pseudo and peripheral devices 
to be included in the target configuration. 


Enter an asterisk (*) for a list of devices and mnemonics. 


For a device-type with multiple controllers, enter the 
device-type, an equal sign (=), and the number of controllers. 
For example, DK=2. Note that SYSGEN assumes one controller for 
the device-type if you omit the equal sign. 


SYSGEN prompts for a device mnemonic until you terminate the 
entry (or the question) with a period (.). 
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Host 
1. Are you running SYSGEN standalone (on the baseline system) 


Enter Yes if you are not running SYSGEN on a previously generated 
RSX-11M system. 


2. Is a line printer available 


Enter Yes if the host configuration includes a line printer. 
(The printer can be used for listing and map files.) 


3. Spool assembly listing and Executive and driver maps 


Enter Yes if you want these files spooled to the line printer. 
Enter No if you want to save the files, but not print them. 


4. Does the listing/map device have at least 120 columns 


Enter Yes if the printer has at least 120 columns. Otherwise, 
SYSGEN forces narrow listings. 


5. Assembly listings device (ddu:) [D: NL:] 


Usually, assembly listing files are not required. If you desire 
or require these files, enter a device specification. 


6. Map device for Executive and device drivers (ddu:) [D: SY:] 


For unmapped systems, mapsS are required. Enter a device 
specification if you do not want to use SY:. 


For mapped systems, the maps may prove helpful. Enter a device 
specification if you do not want to use SY:. 


Be advised that you should not enter NL:. 
EOS * Do you want to: <CR>-continue R-repeat section E-exit P-pause 


A response of carriage return begins Executive option generation. 


4.3 SUMMARY OF EXECUTIVE QUESTIONS 


The following list comprises the possible Executive questions for 
SYSGEN Phase I. Not all of the questions appear during an actual run 
of SYSGEN. For example, some options require Executive support of 
other options; SYSGEN automatically includes Executive support if it 
is required in your system. For complete details on the Executive 
options and their implications, refer to Chapter 5. 


Unless otherwise noted, a Yes response includes Executive support for 
the option. 


1. Will DBMS-11 be used 


Enter Yes to include Data Base Management System support. For 
details on DBMS, see the DBMS-11l documentation. 
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FILES-11 ACP 


Enter Yes to include the services described in the IAS/RSX-11 I/0 
Operations Reference Manual. 


RMS record locking and placement control 


Enter Yes to include support for the Record Management System. 
See the RMS documentation for details. 


Non-resident tasks (task loader) 
Enter Yes to include support for the task loader. The task 
loader: reads a task into memory; performs a checkpoint write 
of a task image from memory to disk; or performs a_ checkpoint 
read of a task image from disk into memory. 

Loadable task loader 
Enter Yes to include support for the loadable task loader. The 
loadable task loader reduces the amount of address space required 
for the Executive. 

Memory managment (PLAS) directives 
Enter Yes to include support for the memory management 
directives. These directives allow tasks greater span of 
physical memory. 

Send/Receive by reference directives 


Enter Yes to include support for the send/receive by reference 
directives. 


Get mapping context directive 
Enter Yes to include support for this directive. 

Address checking 
Enter Yes to include Executive support for address checking. 
This option provides boundary and alignment checks on addresses 
passed by users in Fxecutive directives. 
I/O rundown 
Enter Yes to include Executive support for I/O rundown. This 
option helps insure system integrity by cleaning up outstanding 
I/O before allowing a task (for example Dismount) to exit. 


Multi-user protection 


Enter Yes to generate a multiuser protection system. This option 
protects against destructive interference between users. 


ANSI magtape ; 


Enter Yes to include Executive support for ANSI magnetic tapes. 


13. 


14. 


15. 


16. 


17. 


18. 


19. 


20. 


21. 


22. 


23. 


24. 


25. 


SUMMARY OF SYSGEN PHASE I QUESTIONS 


On-line formatting (FMT) or on-line user-mode diagnostics 


Enter Yes to include support for the volume format (hardware) 
utility (FMT) and User-Mode Diagnostics (UMDs). 


Loadable device drivers 


Enter Yes to include Executive support for loadable device 
drivers. 


Should the default for all applicable drivers be loadable 


Enter Yes to default drivers that can be loaded to be loadable, 
rather than resident. 


AST and cancel selective MARKTIMEs 

Enter Yes to permit processing of Asynchronous System Traps 
(ASTs) and provide the ability to cancel selective marktime 
requests. 

Task termination and device not ready messages (TKTN) 

Enter Yes to include this option. 

Power fail recovery 

Enter Yes to include this option. 


Install, request, and remove or exit 


Enter Yes to include this feature of the Run _ command. This 
feature helps optimize use of Executive dynamic memory resources. 


Large (20K) Executive 


Enter Yes to generate an Executive larger than 16K and thus 
increase pool space. 


Logical device assignment 
Enter Yes to include support for the MCR Assign command. 
Logging of device errors and timeouts 


Enter Yes to permit the error logging subsystem to intercept 
device errors and write status information in a file. 


Logging of undefined interrupts 


Enter Yes to permit the error logging subsystem to record traps 
to undefined interrupt vectors ina file. 


Logging of memory parity errors 


Enter Yes to permit the error logging susbsystem to record cache 
and main memory parity error information ina file. 


Do you intend to include a user-written driver 
Enter Yes if you have written your own device driver(s). SYSGEN 


will permit you to include your drivers when it assembles the 
Executive. 
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Include routine $GTWRD 

Enter Yes to include support for the SGTWRD Executive routine. 
This routine obtains, or fetches, a word from a user-defined 
buffer. 

Include routine SPTWRD 


Enter Yes to include the SPTWRD Executive routine. This’ routine 
sends a word to a user-defined buffer. 


Disk writecheck 


Enter Yes to include disk writecheck support. When enabled, this 
option increases data reliability, but decreases disk throughput. 


Executive debugging tool (XDT) 


Enter Yes to include the Executive Debugging Tool (XDT). XDT is 
useful in debugging privileged tasks and user-written drivers. 


Rotating pattern in data lights 

Enter Yes to include this option. The processor data lights 
rotate in a pronounced circular pattern when the processor is 
idle. 

Industrial network or DECnet 

Enter Yes to include industrial network or DECnet support. 

Queue manager and queued print spooler 

Enter Yes to include complete spooling support. 


Group global event flags 


Enter Yes to include Executive support for group global event 
flags and MCR support for the Flags command. 


Enter code for directives 


Enter an asterisk (*) for a list of the Executive directives and 
then enter the letter(s) that correspond to the desired 
directives. A percent Sign (%) selects all the directives. 
Terminate the question with a period (.). 


Number of pre-allocated QIO packets 


Enter a numeric response in the range 0 to 15 to specify the 
number of QIO packets to allocate from pool. 


A response of 0 excludes the option. 

Note that the default response is 5. Therefore, if you simply 
enter carriage return, you select the option and allocate 5 I/0 
packets from pool. 

Size of data transfer vector in words 

Enter a numeric response in the range 5 to 33 to specify the 


number of MOV instructions to include in the data transfer 
vector. 
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Round-robin scheduling interval in ticks 


Enter a numeric response in the range 0 to 1000 to specify the 
round-robin scheduling interval. 


A response of 0 excludes the option. 

Note that the default response is 5. Therefore, if you simply 
enter carriage return, you Select the option and specify 5 clock 
ticks as the scheduling interval. 


Highest priority class for consideration 


Enter a numeric response in the range 1 to 249 to specify the 
highest, eligible priority class for round-robin scheduling. 


Lowest priority class for consideration 

Enter a numeric response in the range 1 to the response entered 
in question 38 to specify the lowest, eligible priority class for 
round-robin scheduling. 


Executive level disk swapping interval 


Enter a numeric response in the range 0 to 5000 to specify the 
disk swapping interval. 


A response of 0 excludes the option. 

Note that the default is a value equal to the round-robin 
scheduling interval multiplied by 6. Therefore, if you simply 
enter carriage return, you select the option and specify 6 times 
the round-robin interval as the swapping interval. 

If you did not select round-robin scheduling (response of 0 to 
question 37), the default is 30. Therefore, if you simply enter 
carriage return, you select Executive level disk swapping and 
specify 30 as the swapping interval. 

Swapping priority 


Enter a numeric response in the range 1 to 20 to specify the 
range over which lower priority tasks may checkpoint higher ones. 


The default response is 5, which is highly recommended. 
Size of dynamic storage region (POOL) in words 


Enter a numeric response that is in the range 256 to 16384 and a 
multiple of two. 


Seconds between printer not ready messages 


Enter a numeric response in the range 0 to 255 to specify the 


number of seconds between line printer not ready messages. 
A response of 0 suppresses the messages. 


If you make a non-zero entry, the value must be greater than 15. 
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Note that the default is 30 seconds. If you simply enter 
carriage return, the message appears every 30 seconds when the 
line printer is not ready (out of paper, or offline, for 
example). 

Seconds between card reader not ready messages 

Enter a numeric response in the range 0 to 255. 

A response of 0 suppresses the messages. 

If you make a non-zero entry, the value must be greater than 15. 
Note that the, default is 30 seconds. If you simply enter 
carriage return, the message appears twice a minute when the card 
reader is not ready. 

System crash register and stack dump device CSR 


Enter 0 to exclude this option. Otherwise, enter a numeric 
response in the range 160000 to 177700. 


Note that the default response selects the option and dumps_ the 
Executive stack and registers on the console terminal following a 
system crash. 

Checkpointing: A-Yes B-With system ckpnt. file 

Enter A to include checkpointing, B to include checkpointing’ to 
system checkpoint files (and support the Allocate Checkpoint 
Space (ACS) command), or carriage return to exclude checkpointing 
altogether. 

System controlled partitions: A-Yes B-With auto compaction (SHF) 
Enter A to include system controlled partitions, B to include 
system controlled partitions with the shuffler (SHF), or carriage 
return to exclude support for system controlled partitions. 

Dump analysis: A-PANIC B-Crash (CDA) 

Enter A to include the panic dump routine (PANIC), B to include 
the crash dump analyzer (CDA), or carriage return to exclude 
Support for memory dumps following a system crash. 

It is recommended that you select either PANIC or CDA. 

Output notification device CSR 


Enter a numeric value in the range 160000 to 177700 to _ specify 
the CSR address for the CDA routine to output crash notification. 


Memory dump device (ddu:) 


Enter the device mnemonic and unit number for the device you wish 
the CDA routine to direct memory dumps. 


CSR address of dump device 


Enter a numeric response in the range 160000 to 177700 to specify 
the CSR address of the console terminal. 


The default response is the default CSR address of the memory 
dump device. 
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52. CSR address of PANIC dump device 


Enter a numeric response in the range 160000 to 177700 to specify 
the CSR address of the device for the PANIC routine to dump the 
Executive stack and registers. 


The default response causes PANIC to dump the stack and registers 
to the console terminal. 


4.4 SUMMARY OF TERMINAL DRIVER QUESTIONS 


The following list comprises the possible terminal driver questions 
for SYSGEN Phase I. 


l. Terminal driver desired (A/B/C/D, * prints table) 


Enter an asterisk to print a list of the available terminal 
drivers. Then enter A to select the half duplex terminal driver 
that you tailor to your system requirements, B to select’ the 
tailored (user-oriented) half duplex terminal driver, C to select 
the full duplex terminal driver, or D to select the baseline half 
duplex terminal driver. Chapter 5 lists the options included in 
the user-oriented and full duplex terminal drivers. 


2. Unsolicited input timeout value in seconds 
Enter a numeric response in the range 0 to 2540 to specify the 
interval, in seconds, that the full duplex terminal driver waits 
before discarding unsolicited terminal input. 


A response of 0 inhibits the full duplex terminal driver 
unsolicited input timeout feature. 


Note that the default response is 120 seconds. Therefore, if you 
simply enter carriage return, you select this feature and specify 
that the driver timeout after two minutes. 

3. Pass form feeds directly to the terminal 


Enter Yes to suppress conversion of a form feed into 8 line 
feeds, 


4. Automatic carriage return/line feed 


Enter Yes to generate a carriage return and line feed whenever 
the terminal buffer is filled, either on output or echo. 


5. Task checkpointable during terminal input 


Enter Yes to allow tasks to displace checkpointable tasks from 
memory during terminal input. 


6. Unsolicited input character AST 


Enter Yes and a task attaching to a terminal can specify an AST 
entry point on receiving unsolicited input characters. 
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7. Write with CTRL/O cancellation 
Enter Yes to permit write requests with CTRL/O cancellation to 
print to the terminal, regardless of whether or not the terminal 
has suppressed output by CTRL/O. 

8. Breakthrough write 


Enter Yes and breakthrough write requests can print to the 
terminal, regardless of terminal I/O activity. 


9. CTRL/R (retype) 


Enter Yes and CTRL/R sends a carriage return/line feed followed 
by the input buffer to the terminal. 


10. Escape sequence handling 


Enter Yes to recognize and treat escape sequences as line 
terminators. 


ll. Get multiple characteristics 


Enter Yes to allow tasks to determine characteristics of 
individual terminals. 


12. Set multiple characteristics 
Enter Yes to allow tasks to set or reset characteristics of their 
TI: terminal. Privileged tasks can set characteristics of any 
terminal. 


13. Get terminal driver options 


Enter Yes to allow tasks to determine which terminal driver 
options were selected during SYSGEN. 


14. Hold screen mode 


Enter Yes to allow terminals (with special hardware) to break 
output into pages that fit on the screen. 


15. Transparent read/write 
Enter Yes to provide support for I/O functions (IO.RAL and 
IO.WAL) that bypass character filtering and permit output of up 
to 32K bytes. 

16. Settable case conversion for input 


Enter Yes to permit the driver to selectively, on a per-terminal 
basis, convert lower case input to upper case. 


17. Read after prompt 
Enter Yes to permit a read after prompt request to act like a 


write to the terminal followed by a read. This reduces overhead 
and eliminates context switching. 
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Read with no echo 


Enter Yes to permit issuing read functions (IO.RLB, I0O.RVB, and 
IO.RPR) specifying that terminal input not be echoed. 


Read with special terminator 

Enter Yes to permit any character less than 40 octal or greater 
than 174 octal to terminate a read with special terminator 
request. 

CRT rubout support 

Enter Yes to select the backspace-deletion function. 
Terminal-host synchronization 

Enter Yes to allow CTRL/S and CTRL/Q from a terminal. 


User terminal input buffering 


Enter Yes to place input characters directly into a 
non-checkpointable task buffer as received. 


Variable length terminal input buffering 


Enter Yes to allocate buffers large enough to contain read 
requests. 


LA30P support 


Enter Yes to include support for an _ LA30P; this prevents 
discarding the second of two rapidly typed characters. 


Hardware unrecoverable input error support 

Enter Yes to permit the full duplex terminal driver to pass 
characters received after a hardware error to the soliciting 
task, with notification. 

Device independent cursor positioning 

Enter Yes to permit cursor positioning coordinates without 


specifying terminal-type; the full duplex terminal driver 
determines terminal-type. 


SUMMARY OF PERIPHERAL QUESTIONS 


The following list comprises the possible peripheral questions for 
SYSGEN Phase I. Read Chapter 5 for details on _ the peripheral 
questions and the SYSGEN prompt lines. 


Enter [L/R,] vector, CSR for: 


l. CR Controller 0 [D: 230,177160] 


Respond with a carriage return to use the default vector and 
CSR assignments for the first CRll card reader. You must 
enter the vector and CSR addresses of subsequent CRI11 
controllers. 
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CT Controller 0 [D: 260,177500] 


Carriage return uses the default vector and CSR assignments 
for the first TAll cassette controller. Subsequent TA1l1l 
controllers do not have default assignments. 


DF Controller 0 [D: 204,177460] 


Carriage return uses the default vector and CSR assignments 
for the first RFll controller. Subsequent RF1ll controllers 
do not have default assignments. 


MS Controller 0 [D: 224,172522] 


Carriage return uses the default vector and CSR assignments 
for the first TS1l1 controller. Subsequent TS11 controllers 
do not have default vector assignments. 


PP Controller 0 [D: 74,177554] 


Carriage return uses the default vector and CSR assignments 
for the first PCll controller. Subsequent PCll controllers 
do not have default assignments. See Chapter 5. 


PR Controller 0 [D: 70,177550] 


Carriage return uses the default vector and CSR assignments 
for the first PCl1/PR11 controller. Subsequent controllers 
do not have default assignments. See Chapter 5. 


UD Controller 0O [D: 234,171776] 


Carriage return uses the default vector and CSR assignments 
for UDC1l1, Universal Digital Controller. 


XB Controller 0 [D: 124,172414] 


Carriage return uses the default vector and CSR assignments 
for the first DA11-B parallel line interface controller. 
Subsequent DA11-B controllers do not have default 
assignments. 


Enter [L/R,] vector, CSR, number of drives, unit number of first drive, 


2. 


[O=offset recovery support/NO=no support] for: 
DB Controller 0 [254,176700,,0,0] 


Enter two commas (,,) followed by the number of disk drives 
for the first RH11 or RH70 controller. This will use the 
default vector and CSR assignments, specify 0 as the unit 
number of the first drive, and include offset recovery 


support. Subsequent controllers default only the unit number 
of the first drive (to 0). 
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DR Controller 0 [D: 254,176700,,0,0] 


Enter two commas (,,) followed by the number of disk drives 
for the first RH11 or RH70 controller. This will use the 
default vector and CSR assignments, specify 0 as the unit 
number of the first RMO2 or RMO3 drive, and include offset 
recovery. Subsequent controllers default only the unit 
number of the first drive (to 0). 


Enter [L/R,] vector, CSR, number of drives for: 


3. 


DD Controller 0 [D: 300,176500] 


Enter two commas (,,) followed by the number of drives’ for 
the first TU58 controller. This will use the default vector 
and CSR assignments’ for the DECtape II controller. 
Subsequent TU58 controllers do not have default responses. 


DL Controller 0O [D: 160,174400] 


Enter two commas (,,) followed by the number of drives for 
the first RL11 controller. This will use the default vector 
and CSR assignments for the RLO1l cartridge disk controller. 
Subsequent RL11 controllers do not have default responses. 


DP Controller 0 [D: 254,176714] 


Enter two commas (,,) followed by the number of drives for 
the first RP1l controller. This will use the default vector 
and CSR assignments for the RP02/03 disk controller. 
Subsequent RP11l controllers do not have default responses. 


DT Controller 0 [D: 214,177342] 


Enter two commas (,,) followed by the number of drives for 
the first TCll controller. This will use the default vector 
and CSR assignments for the DECtape controller. Subsequent 
TCll controllers do not have default responses. 


DX Controller 0 [D: 264,177170] 


Enter two commas (,,) followed by the number of drives for 
the first RX11 controller. This will use the default vector 
and CSR assignments for the RX0l floppy disk controller. 
Subsequent RX11l controllers do not have default responses. 


DY Controller 0 [D: 264,177170] 


Enter two commas (,,) followed by the number of drives’ for 
the first RX21l controller. This will use the default vector 
and CSR assignments for the RX02 floppy disk controller. 
Subsequent RX211 controllers do not have default responses. 


MM Controller 0O [D: 224,172440] 


Enter two commas (,,) followed by the number of drives’ for 
the first RH11, RH70, TMO2, or TMO3 controller. This will 
use the default vector and CSR assignments for the first 
TU45, TU16, TE16, or TU77 magtape controller. Subsequent 
controllers of this type do not have default responses. 
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MT Controller 0 [D: 224,172522] 


Enter two commas (,,) followed by the number of drives’ for 
the first TMll, TMA11, or TMBl1 controller. This will use 
the default vector and CSR assignments for the first TS03, 
TU10, or TE10O magtape controller. Subsequent controllers of 
this type do not have default responses. 


Enter [L/R,] vector, CSR, F=full duplex/H=half duplex, 


E=error detec. unit/NO=no, C=char. detec unit/NO=no, 
number of sync characters in leader for: 


XQ Controller [D:,,H,E,C] 


Enter the vector address (from floating vector space starting 
at 300), the CSR address (from floating address space 
Starting at 160010), followed by four commas (vector, 
CSR,,,,) and the number of sync characters in a sync leader 
for the first DQ1ll1 synchronous’ line interface. This will 
specify a half duplex line with error and character detection 
units. Subsequent DQl1s default half duplex and error. and 
character detection unit specification. 


Enter [L/R,] vector, CSR, number of drives, unit number of first drive 


5. 


DS Controller 0 [D: 204,172040,,0]) 


Enter two commas (,,) followed by the number of RS03/04 
drives for the first RH11 or RH70 controller. This will use 
the default vector and CSR assignments and specify 0 as_ the 
unit number of the first RS03/04 drive. Subsequent 
controllers default only the unit number of the first drive 
(to 0). 


Enter [L/R,] vector, CSR, highest unit number <0 to 7> for: 


6. 


DK Controller 0 [D: 220,177404] 


Enter two commas (,,) followed by the highest unit number 
(the number of RKOS drives minus one, if you want the first 
unit number to be 0) for the first RK11 controller. This 
will use the default vector and CSR assignments for the RKOS5S 
disk controller and, assign 0 as the unit number of the first 
drive if you enter number of drives minus one for highest 
unit number. Subsequent RK11 controllers do not have default 
responses. 


Enter vector, CSR, VT11/VS60, number of CRT monitors for: 


7. 


GR Controller O [D: ,172000,,1] 


You musSt enter the vector address and whether the connected 
terminal(s) is a VTll or aVS60; the CSR address and the 
number of CRT monitors default to 172000 and 1 respectively. 


for: 
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Enter [L/R,] CSR, number of A/D channels for: 
8. AD Controller 0 [D: 176770] 


Enter a single comma (,) followed by the number of A/D 
channels for the first ADO1-D analog-to-digital converter 
controller. This will use the default CSR assignment for the 
controller. Note that this device is used in non-interrupt 
mode and therefore, does not use an interrupt vector address 
assignment. The CSR address does not default for subsequent 
ADO1-D controllers. 


Enter [L/R,] vector, CSR, number of A/D channels for: 
9. AF Controller 0 [D: 134,172570] 


Enter two commas (,,) followed by the number of A/D channels 
for the first AFC11 analog-to-digital converter controllers. 
This will use the default vector and CSR assignments for the 
AFCll controller. Subsequent controllers do not have default 
responses. 


Enter [L/R,] clock vector, CSR, polarity mask, D=D/A channel/NO=no, 
Maximum number of samples/second, DRK=DR11-K/NO=no 
(,DR11-K CSR) for: 


10. AR Controller 0 [D: ,170400,,,,,170420] 


Enter the clock vector address (from floating vector space 
starting at 300), a comma (,) to use the default CSR address, 
the polarity mask word, whether or not a D/A channel is 
present, the maximum number of samples per second, whether or 
not the DR11-K option is present, and, if present, a comma 
(,) to use the default CSR address for the DRI11-K. 
Subsequent AR11 controllers default only the CSR address of 
the DR11-K options. 


Enter [L/R,] clock vector, CSR, #A/D channels, G=gain ranging option/NO=no, 
polarity mask, bandwith filter channel select delay, 
number of D/A channels, D=digital I/O option/NO=no, 
maximum number of samples/second for: 


ll. LS Controller 0 [D: ,170400,,,0,0,0,NO] 


Enter the clock vector address (from floating vector space 
starting at 300), a comma (,) to use the default CSR address, 
the number of A/D channels, whether or not the gain ranging 
option is present, four commas (,,,,) (to specify 16 bi-polar 
channels, no bandwith filter delay, no D/A channels, and no 
digital I/0 option), followed by the maximum number of 
samples per second for the first LPS1l1l controller. 
Subsequent LPS11 controllers do not default the CSR address. 
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Enter [L/R,] vector, CSR (, number of UMRSsS) for: 


12. 


LA Controller 0 [D: 300,170460,0] 


Enter two commas (,,) for the first LPAl1 controller. This 
will use the default assignments and excludes LPA11-K UNIBUS 
Mapping Register support. 


Enter [L/R,] vector, CSR, # drives, O=offset recovery/NO=no offset rec 


13. 


DM Controller 0 [D: 210,177440,,0] 


Enter two commas (,,) followed by the number of drives’ for 
the first RK611 controller. This will use the default vector 
and CSR assignments for the RK06/07 disk controller and 
include offset recovery support. Subsequent RK611 
controllers do not have default responses. 


Enter [L/R,] vector, CSR, F=full duplex/H=half duplex, 


14. 


14. 


14. 


14. 


number of characters in sync leader for: 
XL Controller O [D: ,,H] 


Enter the vector address (from floating vector space), the 
CSR address (from floating address space starting at 175610), 
whether the line is half duplex or full duplex (the default 
is half duplex), and the number of sync characters in a sync 
leader for the first DL11-E interface. Subsequent DL11-Es do 
not have a default response. 


XP Controller 0O [D: ,174770,H] 


Enter the vector address (from floating vector space starting 
at 300) followed by two commas (,,) and the number of sync 
characters in a sync leader for the first DPll interface. 
This will use the default CSR assignment and specify a half 
duplex line. Subsequent DPlls default only the half duplex 
parameter. 


XU Controller O [D: ,,F] 


Enter the vector address (from floating vector space starting 
at 300), the CSR address (from floating address_ space 
Starting at 160010), whether the line is half duplex or full 
duplex (the default is full duplex), and the number of sync 
characters in a syne leader for the first DU1ll line 
interface. Subsequent DUlls default only the full duplex 
parameter. : 


XW Controller O [D: ,,H] 


Enter the vector address (from floating vector space starting 
at 300), the CSR address (from floating address space 
Starting at 160010), whether the line is half duplex or full 
duplex (the default is half duplex), and the number of sync 
characters in a syne leader for the first DUP11 line 
interface. Subsequent DUP11s do not have default responses. 


for: 
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Enter [L/R,] vector, CSR, F=full duplex/H=half duplex/P=primary HDX for: 
15. XM Controller 0 


Enter the vector address (from floating vector space starting 
at 300), the CSR address (from floating address space 
starting at 160010), and whether the line is full duplex or 
half duplex for the first DMCll interprocessor link. Note 
that if the line is half duplex and the primary station, you 
must enter P. 


Enter [L/R] vector, CSR, printer type 
(, [KMC timeout count <0=no KMC>, KMC vector, KMC CSR]) for: 


16. LP Controller 0 [D: 200,177514,LA180,0,300,160130] 


Enter three commas (,,,) for the first LP1ll controller. This 
will use the default vector and CSR assignments and exclude 
KMC line printer support. 


Enter number of modules, module number of first for: 


17. UD Controller 0 ADUOI1 analog input module 
17. UD Controller 0O analog output module 

17. UD Controller 0 bi-stable output module 
17. UD Controller 0 digital interrupt module 
17. UD Controller 0 digital sense module 

17. UD Controller O I/O counter module 

17. UD Controller O single-shot output module 


The UDCll supports seven modules; enter the number of each 
module and the module number of the first. 


Enter [L/R,] terminal number to redirect to (TTn:) for: 
18. CO Controller O [D: 0] 


Carriage return uses TTO: as the terminal for the console 
output driver. 


Enter [L/R,] NUM. DL11's <ZL>, NUM. DH11's, NUM. DZ1ll1l's, NUM. DJ11's for: 
19. The terminal driver [D: 1,0,0,0] 


Enter carriage return to specify that you have one DLll 
asynchronous line interface. 


Note that this question appears only if you selected the user 
oriented or the baseline terminal drivers; the full duplex 
terminal driver is always loadable. 
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Enter NUM. DL11l's <ZL>, NUM. DH11'S, NUM. DZ11'S, NUM. DJ1l1's for: 


20. 


The terminal driver [D: 1,0,0,0] 


Enter carriage return to specify that you have one DL1l 
asynchronous line interface. This question appears only if 
you selected the full duplex terminal driver. 


Enter vector, CSR for: 


21. 


ZL Controller O [D: 60,177560] 


Carriage return uses the default vector and CSR assignments 
for the first DL11 asynchronous line interface. Subsequent 
DL11ls do not have default responses. 


Enter vector, CSR, highest line number <0 to 15> 


22. 


(,answer speed, DM11-BB vector, DM11-BB CSR) for: 


DH Controller 0 [D: ,,,300,0,0] 


Enter the interrupt vector address (from floating vector 
space), the CSR address (from floating address space), and 
the highest line number (0O=one line, 15=sixteen lines). This 
will exclude DM1l1-BB support for the first DH11 interface. 
If the DH11 includes DM11-BB modem support, you must also 
enter the answer speed (300 is the default), the DM11-BB 
interrupt vector address (from floating vector space), and 
the DM11-BB CSR (from floating address space). Subsequent 
DH1lls do not have default responses. 


Enter vector, CSR, highest line number <0 to 15> for: 


23. 


DJ Controller 0 


Enter the interrupt vector address (from floating vector 
Space), the CSR address (from floating address space), and 
the highest line number (O=one line, 15=sixteen lines) for 
the first DJ11 multiplexer. 


Enter vector, CSR, highest line number <0 to 7> [,answer speed] for: 


24. 


DZ Controller 0 [D: ,,,0] 


Enter the interrupt vector address (from floating vector 
space), the CSR address (from floating address space), and 
the highest line number (0=one line, 7=eight lines) for the 
first DZ11 multiplexer. This will exclude DZ1l modem 


support. If you wish modem support, enter the answer speed 
baud rate. 


If 
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you selected an MM device, SYSGEN requests’ the 


number as follows: 


If 


If 


If 


Tf 


If 


If 


If 


TM02/03 


51. MM controller 0 unit 0. formatter [D R:0-7 D:0] 


The default is unit number 0. 


you selected a DB device, SYSGEN requests drive 


type 


52. Contr 0 unit 0. is an RP04,05/RP06 [D:RP06] 


The default is RPO6. 


you selected a DL device, SYSGEN requests drive 
53. Contr 0 unit 0. is an RLO1/RLO2 [D:RLO1] 


The default is RLO1l. 


you selected a DM device, SYSGEN requests drive 
54. Contr O unit 0 is an RKO6/RKO7 [D:RK06] 


The default is RKO6. 


you selected a DP device, SYSGEN requests drive 
55. Contr O unit 0 is an RPO2/RP03 [D:RPO3] 


The default is RPO3. 


you selected a DR device, SYSGEN requests drive 
56. Contr 0 unit 0 is an RMO2/RMO3 [D:RMO03] 


The default is RMO3. 


you selected a DS device, SYSGEN requests drive 
57. Contr 0 unit 0. is an RSO3/RS04 [D:RS04] 


The default is RSO4. 


you selected a DY device, SYSGEN requests drive 
58. Contr 0 unit 0. is SINGLE/DOUBLE density 


You muSt specify whether the RxX02_ drive 
double density. 


type 


type 


type 


type 


type 


as 


as 


as 


as 


as 


as 


density 


is 


at 


formatter 


follows: 


follows: 


follows: 


follows: 


follows: 


follows: 


as follows: 


single or 
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If you selected ICS/ICR subsystems or DSS/DRS modules, SYSGEN asks the 
following questions. 
1. Expanded comments for ICS/ICR questions 
Enter Yes for explanatory text. 
2. Do you want task activation from unsolicited interrupts = 


Enter Yes to permit the driver to initiate a task when the 
driver receives unsolicited input. 


3. IC controller 0 vector address 


Enter the interrupt vector address. The standard is 234. 
The acceptable range is 234-774. 


4. CSR address 


Enter the CSR address. The standard is 171776. The 
acceptable range is 160000-177700. 


5. Is it an ICR-11 
Enter Yes to specify an ICR-1l, No to specify an ICS-1l. 
6. Number of A/D converter modules in this ICS/ICR 
Enter the number of modules in the range 0-16. 
7. A/D converter module number 
Enter the A/D converter module number in the range 0-35. —™, 
8. Number of expansion multiplexers 
Enter a value in the range 0-7. 
The ICS/ICR subsystem consists of six modules. SYSGEN requests’ the 
number of modules (questions 12-17) and the module number of each 
(question 9). 


12. Number of D/A converter modules in this ICS/ICR 


13. Number of single-shot output modules in this ICS/ICR am 
14. Number of bi-stable output modules in this ICS/ICR 
15. Number of digital sense modules in this ICS/ICR 
16. Number of digital interrupt modules in this ICS/ICR 
17. Number of I/O counter modules in this ICS/ICR + 
9. (module name) module number 
10. Restore module status on power and error recovery 

Enter Yes to select this option. 7 
11. How many line errors are acceptable per second 

If you selected option 10, enter a value in the range 0-5000. : an, 
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18. Expanded comments for DSS/DRS questions 
Enter Yes for explanatory text. 
19. Number of DRS-11 modules 
Enter a value in the range 0-16. Questions 20, 21, and 22 
pertain to DRS-1l1 modules; if you enter 0, these are 
omitted. 
20. Restore module status on power and error recovery 
Enter Yes to select this option 
21. DRS-11 CSR address 
Enter a value in the range 160000-177700. 
22. DRS-11 vector address 
: Enter a value in the range 300-774. 
23. Number of DSS-11 digital input modules 
Enter a value in the range 0-16 minus the response to 
question 19. 
24. DSS-11 CSR address 
Enter a value in the range 160000-177700. 
25. DSS-11 vector address 
Enter a value in the range 300-774. 
26. Task activation from unsolicited interrupts 
Enter Yes to select this option. 
If your system includes IP11/IP300 support, SYSGEN asks the following 
questions. 
1. Extended comments for IP11/IP300 
Enter Yes for explanatory text. 
2. Treat all controllers as one unit 
Enter Yes to generate a single SCB and UCB for all 
controllers. 
3. Any latching digital output modules ; 
Enter Yes to include support in driver. 
4. Any Single-shot output modules 


Enter Yes to include support in driver. 


10. 


ll. 


12. 


13. 


14. 


15. 


16. 


17. 


18. 
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Direct output via QIO 

Enter Yes to simplify coding, but increase overhead. caieaaal 
Any non-interrupting digital sense modules 

Enter Yes to assemble code for this module. 

Any interrupting digital sense modules 

Enter Yes to assemble code for this module. 

Any change-of-state modules 

Enter Yes to assemble code for this module. 

Any counter modules 

Enter Yes to assemble code for this module. 

Direct input via QIO 

Enter Yes to simplify task code at the expense of overhead. 
Unsolicited interrupt support 


Enter Yes and tasks can monitor unsolicited interrupts from 
the interrupting modules. 


Event flag linkage to interrupts 


Enter Yes to permit tasks to monitor digital interrupts 
through event flags. ae 


Any D/A converters 

Enter Yes to assemble code for this module. 

Any A014 A/D converters 

Enter Yes to assemble code for this module. 

Any A020 A/D converters 

Enter Yes to assemble code for this module. 

How many output bytes should be saved on powerfail 
Enter a value in the range 0-3048(10). 

IP1l1 vector 


Enter a value in the range 60-774. The standard vector is - 
234. 


Base address 
Enter the IPl1l1 base address (base address is CSR minus 377 


octal). The default for the first controller is 171000 and 
171400 for the second. Acceptable range is 160000-177400. 


CHAPTER 5 


DETAILS OF SYSGEN PHASE I 


This chapter contains detailed descriptions of SYSGEN Phase I 
questions by sections. The phase 1 sections are: 


Setup Questions 

Target Questions 

Host Questions 

Executive Questions 
Terminal Driver Questions 
Peripherals Questions 


The questions are listed in numeric. order. Not all the questions 
appear; the order of the questions is based on your responses. Also, 
the peripherals section follows a strict numeric order, not logical 
sequence. 


Figure 5-1 shows the processing steps that take place during SYSGEN 
Phase I. 


SYSGEN.CMD 
SYO: 1. Invoke SYSGEN. 


SYSSAVED.DAT 


SyesnvepeMe SYSTEM c 
or Target Volume ‘MA 


: RSXASM.CMD 
oe Inet i 2. i SYSGEN Part | RSXDRVASM.CMD 
a ety uestions. 7 JRSXBLD.CMD 
padre @ Setup questions SGMPARM.CMD 
cola @ Target questions ICSBLD.CMD 
e Host questions ICRBLD.CMD 
SYSSAVED.DAT e Executive questions 
RSXMC.MAC e@ Terminal driver 
SYSTB.MAC questions 
RSXASM.CMD e Peripherals questions 
RSXDRVASM.CMD 3 3. Assemble the executive, RSX11M.OBJ 
RSXBLD.CMD device drivers, terminal 
SGMPARM.CMD driver, and privileged 
ICSBILD.CMD tasks. 
ICRBLD.CMD 


Figure 5-1 Processing Steps in SYSGEN Phase I 
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Step 1 in Figure 5-1 is invoking SYSGEN, as described in Chapter 3. 


Step 2 in Figure 5-1 is answering the questions in each of the 
sections in SYSGEN Phase I. For this process, you can answer all 
the questions explicitly at your terminal, you can use_ saved 
answers, or you can use a combination of saved answers and 
explicit answers. 


As you answer the Phase I questions that define your system, 
SYSGEN is building files that correspond to your answers. These 
files are the output of SYSGEN Phase I: 


SYSSAVED SYSSAVED is the file that contains symbols that 
correspond to your answers to SYSGEN Phase I questions. 
SYSSAVED.CMD is used as input to later SYSGENS. 
SYSSAVED.DAT is the output from a SYSGEN. 


RSXMC.MAC RSXMC.MAC is the assembler source file that comprises 
the executive features defined during SYSGEN Phase I. 
This file is assembled in Step 3. 


SYSTB.MAC SYSTB.MAC is the assembler source file that contains 
the data structures for devices selected during SYSGEN 
Phase I. 

RSXASM.CMD RSXASM.CMD is the command file that controls assembly 


of the executive. 


RSXDRVASM.CMD RSXDRVASM.CMD is the command file that controls 
assembly of the device drivers. 


RSXBLD.CMD RSXBLD.CMD is the command file that controls the task 
building of the executive. 


SGNPARM.CMD SGNPARM.CMD is the RSX-11M indirect command processor 
file that contains symbols defined in SYSGEN Phase I 
for use in controlling SYSGEN Phase II processing. 

ICTAB.MAC ICTAB.MAC contains the ICS/ICR data structures. 


Step 3 in Figure 5-1 is the assembly of the executive, device drivers, 
terminal driver, and privileged tasks. 


Input to Step 3 is output of Step 2; refer to description of 
those files above. 


SYSGEN controls the assembly and creates an object file that 
corresponds to the system you defined in Step 2. 


If all assemblies are successful, SYSGEN completes execution and 
displays the <EOF> prompt. 


5.1 SYSGEN SETUP QUESTIONS 


The SYSGEN Phase I setup section asks questions that provide SYSGEN 
with information describing the way you want the program to execute, 
input to SYSGEN, and what kind of output you want from SYSGEN. 


ed 


wd 
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SYSGEN asks a series of questions that define whether to: 
@ Execute MCR commands 
e Use saved answers as input to SYSGEN 
e Use breakpoints 


When you are generating a system for the first time, you may wish to 
follow the logical flow through the SYSGEN command files. For this 
case, the setup section of SYSGEN asks the question: 


* 1, Do you want to inhibit the execution of MCR commands [Y/N]: 


An affirmative response to this question prevents SYSGEN from creating 
or deleting files as well as inhibiting MACRO-11 and the Task Builder 
execution, UIC modification, device mounting, and logical assignments. 


When you inhibit MCR commands, SYSGEN asks all Phase I questions as 
usual, and creates SYSSAVED.DAT if you request it, but doesn't execute 
MCR commands required to build a system. 


This feature allows you to practice the system generation to see how 
SYSGEN asks questions and to plan the way you want to answer questions 
when MCR commands are not inhibited in later system generations. 


SYSGEN provides breakpoints, or pauses in execution, during system 
generation. There are three types of breakpoints: 


e End-of-Section (EOS) Breakpoints 
e End-of-Execution (EOX) Breakpoints 
e End-of-Disk (EOD) Breakpoints 


These breakpoints are used for various purposes, but can be overridden 
so that SYSGEN can execute unattended when that is appropriate. 


End of section breakpoints are pauses at the end of each section of 
SYSGEN dialogue questions. In SYSGEN Phase I, there are six sections 
of dialogue questions. You can choose to answer the questions in all 
sections without interruption or you can direct SYSGEN to pause after 
you answer each section. This breakpoint in the dialogue gives you 
the opportunity to: 


@e Continue the dialogue 

e Repeat the section of question, perhaps to correct previous 
answers 

e Exit the SYSGEN program 

e Suspend execution of the SYSGEN program (.PAUSE) 


Note that if you type CTRL/Z in response to any question, SYSGEN exits 
cleanly (for example, closes all files). 


Figure 5-2 shows where End-of-Section breakpoints occur in the flow of 
SYSGEN Phase I. 


Execution breakpoints (EOX) in the SYSGEN procedure occur after 
completion of a MACRO assembly or a Task Build operation. SYSGEN can 
pause at these points to ensure successful completion of the assembly 
or build operation. When you know files will execute successfully, 
you can direct SYSGEN to continue processing without the breakpoint 
pause. 
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Figure 5-2 shows where End-of-Execution breakpoints occur in the flow 
of SYSGEN Phase I. 


@SYSGEN 

! 

! 

Setup Questions 

! fd 
! 
EOS 

J 

! 

Host and Target Questions at 
! 

! 
EOS 

S 

! 

Executive Questions 

{ 

! 
EOS 

! 

! 

Peripherals Questions 
! 

1 
EOS 


Executive Assembly 


EOX 
! 
! 
Executive Task Build 
! 
! 
EOX 
! 
! 
Terminal Driver Task Build Aan, 
! pes 
! 
EOX 
! 
! 
Privileged Tasks Task Build 
{ 
! 
EOX 


Figure 5-2 End-of-Section and End-of-Execution Breakpoints in 
the Flow of SYSGEN Phase I 


As shown in Figure 5-2, a flow of execution through SYSGEN Phase I can 
be interrupted by end-of-section breakpoints. During Phase II, SYSGEN 
execution can be interrupted by end-of-execution breakpoints. You can 
direct SYSGEN to override these breakpoints and execute unattended by 
means of questions asked in the setup section of SYSGEN Phase I. amr, 
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End~-of-disk breakpoints (EOD) occur in system generations with RKO5 
distribution kits. After SYSGEN completes processing with the EXCSRC 
volume in the RKO5 kit, SYSGEN prompts you for the next disk required: 


* EOD * If not in [dduu:], enter driver source files device 
(dduus ) : 


At this point, you remove EXCSRC from the drive and replace it with 
DRVSRC. 


In the same cases, where your configuration includes more than two 
drives, you can override EOD breakpoints to run SYSGEN unattended. 


Parts I, II, and III of SYSGEN all reside in UFD [200,200]. However, 
while it executes, SYSGEN resets the UIC under which it runs to store 
files in appropriate UFD's. 


When you stop SYSGEN execution, for any reason, and want to resume 
execution later, ensure that you set your UIC to [200,200]. 


The following is a list of the questions. 
* 1. Inhibit MCR command lines (Type <ESC> for explanation) 


This option permits you to perform a  PREPGEN; the SYSGEN 
questions are asked in the logical order (based on your 
responses), but SYSGEN inhibits the processing of MCR commands and 
commands that assemble, build, create, or delete files. A PREPGEN 
permits you to follow the logical flow of a SYSGEN and helps 
familiarize you with the questions specific to your SYSGEN. Also, 
a PREPGEN allows you to schedule actual SYSGEN processing; you 
perform a PREPGEN, save the responses (answer Yes to setup 
question 10), and then submit the saved answer file for SYSGEN 
processing at your convenience. 


NOTE 


To successfully complete a PREPGEN, you 
must mount all required volumes as well 
as establish logical assignments for 
pseudo devices SY: and LB:. Refer to 
Chapter 3. 


If you respond Yes, SYSGEN asks Setup Question 3; if you respond 
No, SYSGEN asks Setup Question 2. 


* 2. Have you made a copy of the distribution kit 
A copy of the distribution kit insures that you have a backup copy 
in case you inadvertently delete important files or data during 
the system generation process. Also, a backup copy serves as a 


base for future updates. 


If you answer this question No, SYSGEN displays the message: 


SGN -- You are or will be running on the original copy of the 
distribution kit. Make a copy via the standard procedure and 
restart. 


SYSGEN then exits to allow you to copy the media. 
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* 3, Use saved or canned answer file for input responses 


This question permits you to direct SYSGEN to use a saved answer ar 
file (either a canned or a SYSGEN created one) as input. If you 
respond Yes, SYSGEN uses a file named SYSSAVED.CMD to obtain 
responses to questions. Note that SYSGEN does not save responses 
for ICS/ICR, DSS/DRS, or IP11/IP300 devices; you must enter’ the 
responses for these devices. Question 10 provides details 
concerning saved answer files. 


If you respond Yes, SYSGEN asks you whether or not you want to 
re-answer the host or device configuration questions and bypass 
breakpoints in Setup Questions 4, 5, 6, 7, and 8: these questions 
provide options for use with saved answers. If you respond No and 
you are using the RKO5 kit, SYSGEN asks question 9; for other 
kits SYSGEN asks question 10. 


* 4, Undefined answer wakeup 


This feature causes the terminal bell to ring when SYSGEN 
encounters an undefined symbol when using the saved answer file ap 
SYSSAVED.CMD (SYSGEN precedes the question with a CTRL/G). ea. 


This question is asked only if you responded Yes to question 3 
(Use saved answers). 


* 5. Use saved host configuration 


This question allows you to use previously-defined (saved) answers 
to host section questions. In the case where you are running 
SYSGEN online and already have all the listings you need, you may 
want to redefine the host answers in the saved answer file 
(SYSSAVED.CMD) to redefine the way SYSGEN handles’ listings. An 
affirmative response implies that you are performing a SYSGEN on 
the same, or similar, configuration you used to create the saved 
answer file. 


This question is asked only if you responded Yes to question 3 
(Use saved answers). 


* 6. Use saved peripheral configuration 


This question provides you the opportunity to use the 
previously-defined (saved) peripheral configuration contained in 
the file SYSSAVED.CMD. 


If you respond Yes to this question, SYSGEN uses the saved 

peripheral configuration specified by the symbols S$DEV, $DV2, and 

S$DV3. If you respond No, SYSGEN asks Executive question 16. Note 

that a negative response does not affect the saved answers and + 
does not permit you to change vectors or CSRS of previously 

defined devices. A negative response permits you to change only 

the number of controllers; respond No to. add or delete 

controllers. 


This question is asked only if you responded Yes to question 3 
(Use saved answers). 
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* 7. Skip end of section (EOS) breakpoints 


This question allows you to choose whether or not to_ skip 
End-of-Section (EOS) breakpoints. At these breakpoints, you can 
select whether to continue SYSGEN questions, repeat questions in 
the preceding. sections (to correct wrong answers), exit from 
SYSGEN, or cause SYSGEN to pause. This feature is also one which 
in combination with other features defined in this section, allows 
you to run unattended SYSGENs. 


Breakpoints occur at the following points in SYSGEN Phase I: 


e After the Target and Host section 
e After the Executive and Terminal Drivers section 
e After the Peripherals questions 


If the answers in SYSSAVED.CMD already define the system you want 
to generate, you can direct SYSGEN to complete execution of Phase 
I without interruption by answering Yes to this question. 


Note that the laboratory and I/O peripherals questions cannot be 
repeated (aS can Executive questions). However, if you specify 
repeat at the EOS breakpoint, SYSGEN renames SYSSAVED.DAT to 
SYSSAVED.CMD so that you can continue where you left off. 


This question is asked only if you responded Yes to question 3 
(Use saved answers). 


* 8. Skip end-of-execution (EOX) breakpoints 


End-of-Execution (EOX) breakpoints occur after the MACRO-11 
assembler and the Task Builder complete execution. If you know 
that processing will complete successfully, answer Yes to direct 
SYSGEN to process without pausing at completion of MACRO-11 or 
Task Builder execution. 


If you answer No, SYSGEN pauses after execution of these tasks to 
allow you to check and correct the results. 


This question is asked only if you responded Yes to question 3 
(Use saved answers). 


* 9, Skip end of disk (EOD) breakpoints 


The dual RKO5 distribution kit imposes a breakpoint when you must 
change disks after assembling the Executive. You must swap the 
EXCSRC disk with the DRVSRC disk to assemble the device drivers. 


An affirmative (Yes) response to this question implies that a 
third disk drive is available and that the drive contains the 
driver source files. Thus, SYSGEN can assemble the Executive, 
using the EXCSRC disk, and then assemble the device drivers, 
without interruption, using the drive that contains the driver 
source files. If you respond Yes to this question, you are asked 
(in question 15) to identify the device that contains the driver 
source files. Note that this device can be a third RKO5 drive or 
a drive of a different type. (If a drive of a different type is 
used, the volume must completely contain the contents of the 
DRVSRC disk. Also, the driver must be loaded and you must mount 
the volume.) 
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* 10. Save responses (i.e.: create SYSSAVED.DAT) 


When you respond Yes to this question and request a saved answer 
file, SYSGEN creates an indirect command file named SYSSAVED.DAT. 
This file consists of .SET directives which assign values to. the 
symbols defined by your responses to SYSGEN questions (indirect 
command file processor directives are described in the 
RSX-11M/M-PLUS MCR _ Operations Manual). For example, when you 
enter a processor type in response to target question 1 (Such as 
11/70), SYSGEN writes the following line to the file SYSSAVED.DAT: 


~SETS $TPR "11/70" 


Appendix A lists all the symbols that SYSGEN defines in a_ saved 
answer file and identifies the option that each symbol represents. 
You can then use the saved answer file as input to a later SYSGEN 
simply by renaming the file to SYSSAVED.CMD and responding Yes to 
question 3. Thus, saved answer files permit you to generate 
duplicate or similar systems without the need to answer the SYSGEN 
questions. 


More importantly, you can edit the SYSSAVED.DAT file to correct an 
errant response or to alter specific system characteristics. For 
example, you generate a system, but do not include 20K Executive 
support and then find you need more DSR space. The saved answer 
file permits you to generate the same system, except with support 
for a 20K Executive; simply edit SYSSAVED.DAT and set symbol $20K 
to true (.SETT $20K). Then rename SYSSAVED.DAT to SYSSAVED.CMD 
and submit the command file as input to SYSGEN. All the options 
you included in the 16K Executive system are then included in’ the 
20K Executive system. To correct an errant response, enter Exit 
at the next end-of-section breakpoint or respond with CTRL/Z to 
any question (CTRL/Z closes SYSSAVED.DAT and exits SYSGEN). You 
can then edit and rename the command file and restart SYSGEN. 


If you alter specific system characteristics, be sure to read the 
detailed description of those options/features. Some options, 
like cat and mouse, are mutually exclusive and some options 
require or automatically include other options. 


Note that in extreme cases where you change the system complexion, 
it is more practical to perform a complete SYSGEN rather than 
attempt to edit the saved answer file. For example, do not toggle 
the settings for $11S or SMAP, since these symbols effect 
system-wide characteristics. 


You can delete any number of responses in SYSSAVED.CMD; SYSGEN 
asks the respective question when a symbol is missing from the 
saved answer file. In this case, it is especially useful to 
specify undefined answer wakeup (respond Yes to question 4). 


NOTE 


SYSGEN does not save answers for 
DRS/DSS, ICS/ICR, or IP11/IP300 devices. 
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* 11. UIC for SYSSAVED files if not [defaultuic] 


If you want to use saved answer files, enter the UIC of the saved 
answer file you are using or will create. In certain cases, you 
may want to have features for various systems, each system created 
under a different UIC. 


If you respond with a carriage return, SYSGEN uses your. current 
UIC for saved responses. Otherwise, enter the UIC under which you 
want responses saved. 


* 12. UIC for SYSGEN command files if not [sysgenuic] 


This question allows you to select the UIC under which SYSGEN 
looks command files. 


If you are not inhibiting MCR lines, sysgenuic is [200,200]. If 
you are inhibiting MCR lines, sysgenuic is the same as the default 
UIC of the terminal when you invoke SYSGEN. 


* 13. Clean up files from previous GENs 


In cases where you are generating multiple systems on the- same 
media, SYSGEN creates files that may not be appropriate from one 
system to the next. This question gives you the opportunity to 
request that SYSGEN delete all such unnecessary files. 


This question is asked only if you respond No to Setup Question 1 
(Inhibit MCR commands). 


* 14. Device, when ready, for Executive sources (ddu:) [D:SY:]: 


Enter the device type and unit number (ddu:) for the unit 
containing the Executive source files (on volume EXCSRC), for 
example, DKl:. The trailing colon is appended by SYSGEN when it 
is omitted. 


The default when you are using a big disk distribution kit is SY:. 


This question is always asked. 


NOTE 


If you are performing a PREPGEN, SYSGEN 
does not issue a Mount command for the 
Executive source device. (See Chapter 
3) 


* 15. Device, when ready, for driver sources (ddu:) 


This question appears only if you are using the dual _ RKOS5 
distribution kit and responded Yes to question 9 (skip end-of-disk 
breakpoints). 


Enter the device type and unit number (ddu:) for the unit 
containing the driver source files (DRVSRC), for example, DK3:. 
The trailing colon is appended by SYSGEN when it is omitted. 


DETAILS OF SYSGEN PHASE I 


5.2 TARGET CONFIGURATION DEFINITION QUESTIONS 


This section of questions defines the processor type and options, 
system type, and peripheral devices included in the target system. 


* 1. Processor (e.g.: 11/34, LSI-11) [5:6] 


* 


Enter the target processor type. 
Valid entries are: 


11/03 11/23 11/55 
11/04 11/34 11/60 
11/05 11/35 11/70 
11/10 11/40 LSI-11 
11/15 11/45 
11/20 11/50 


This question is always asked. 


2. Does processor have a switch register 


The switch register is the register that contains the toggle 
settings on the front panel of your processor. Certain processors 
(the 11/34, for example) may have neither toggles nor a_ switch 
register. 


If your processor does not have a switch register, you are 
restricted from’ using the Executive directive, GSSWS (Get Sense 
Switch), which reads the contents of the switch register. 


This question appears only if your processor, as defined in Target 
Question 1, is a PDP-11/03, 11/04, 11/34, or 11/60. Other 
processors always include a switch register. 


* 3. Generating RSX-115S 


The answer to this question specifies whether you are generating 
an RSX-11M or RSX-11S system. 


This question is always asked. 


* 4, Memory size (in K-word blocks) [min:max] 


Enter the amount of memory for your processor in 1024-word blocks. 
The legal range is from 16K through 1920K; but depends on the 
minimum and maximum memory sizes for your processor. SYSGEN 
calculates the range values (min and max) based on your response 
to question l. 


The table below shows the minimum and maximum memory sizes for 
RSX-11M-supported PDP-11 processors. 


Note that memory size must be specified in 4K increments. 


J 


DETAILS OF SYSGEN PHASE I 


Processor Default Memory Size 
11M 118 

min max min max 
LSI-11, 11/03 not supported 8 28 
11/04 16 28 8 28 
11/05, 11/10 16 28 8 28 
11/15, 11/20 16 28 8 28 
11/70, 32 1920 32 124 
all others 16 124 8 124 


In the category “all others," above, the processors are the 
PDP-11/34, 11/35, 11/40, 11/45, 11/50, 11/55, and 11/60. 


NOTE 


If your processor is an 11/70 and _ you 
want the 22-bit addressing option, you 
must specify a memory size of 128K or 
greater. 


* 5. Mapped 


The answer to this question specifies whether the target system 
includes the Memory Management Unit (KT-11). If it does, enter 
Yes to generate a mapped system. This question is always asked. 


The memory size you specify in question 4 must be consistent with 
the mapping option; you must have at least 24K of memory to 
generate a mapped system and a maximum of 28K to generate an 
unmapped system. 


The LSI-11, PDP-11/03, 11/04, 11/05, 11/10, 11/15, and 11/20 
processors do not support mapped systems. 


You must answer Yes if your processor has more than 28K of memory. 
If you enter a memory size inconsistent with the mapping option, 
SYSGEN displays an error message and repeats both questions. 


If you respond Yes to this question, SYSGEN automatically includes 
Executive support for address checking and I/O rundown (see 
Executive questions 9 and 10). 


* 6. Any K-Series laboratory devices 


The K-series laboratory options are a set of real-time data 
acquisition modules which interface to the PDP-11l family of 
computers, 


Answer YES if you want support for the K-series software routines 
(see the RSX-11M/M-PLUS I/0 Drivers Reference Manual). If you 
enter Yes, SYSGEN automatically includes connect to interrupt and 
AST and cancel selective marktime support. 


* 7. Extended arithmetic element (KE11-A/B EAE) present 


The extended arithmetic element (EAE) is a hardware feature that 
performs signed integer multiplication, division, 
multiple-position shifts, and normalization. The EAE performs 
these functions significantly faster than software subroutines. 
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This question is not asked if the processor has memory management 
and is not asked for non-UNIBUS PDP-lls (for example, the PDP11/03 
and LSI-11). aan, 


* 8. Floating point processor (FP11) present 


The PDP-11 floating point processor (FP11-A,C,E) performs all 
floating point arithmetic operations and converts data from . 
integer to floating point format and vice versa. The FP11-A is 
available for the PDP-11/34 processor. The FP11-C is available on 
the PDP-11/45, 11/50, 11/55, and 11/70 processors. The FP11-E is 
available for the PDP-11/60 processor. Also, there is a floating 
point option for the 11/23 that is compatible with the FPll. ~. 


This question does not appear for other processors. 


If the target processor is a PDP-11/60, floating point support is 
automatically included and the question is not asked. 


This feature should not be confused with the floating instruction 
set (FIS) available on the PDP-11/40 processor. 


If you respond No to this question, Target Question 9 is asked. 
If you respond Yes to this question, SYSGEN automatically includes 
Executive support for Asynchronous System Traps (AST support) (see 
Executive question 16). 
* 9, Floating instruction set (FIS) present 
The floating instruction set (FIS) feature includes hardware 
functions that perform floating point add, subtract, multiply, and am, 
divide instructions. This feature is available only on_ the 
This question is asked only if the target processor is one listed 
above. 


* 10. If using KW11-P as system clock: number of ints/sec.[0:1000.] 


RSX-11M/S requires a real-time clock for operations. Three clocks 


are available: the KW11-P programmable frequency clock, the 
KW11-L line frequency clock, and the DL11-w line frequency 
clock/console. If your system has a KW-11P and you want to use 


this clock as your system clock, the acceptable range is from 1 
through 1000. : 


A response of 0 indicates there is no programmable clock in this 
configuration or that you want to use the line frequency clock. 


This question is not asked if your processor is the LSI-1l, = 


The number of interrupts you select must be divisible evenly into 
10000. 


More than 100 (decimal) clock interrupts-per-second greatly 
increases system overhead; you should carefully consider the 
impact on your system before specifying a number greater than 100 
(decimal) per second. 
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* 11. Line frequency: A- 60 Hz B- 50 Hz [Default: "A"] 


You can specify a line frequency of either 50 or 60 hertz. In the 
USA, line frequency is always 60 hertz. The default response is 
60 hertz. 


This question is always asked. 


* 12. KW11-Y Watchdog timer support 


The KWl1-Y watchdog timer is a hardware clock that constantly 
attempts to time-out system activity. The executive refreshes the 
timer at every clock interrupt. If the system faults or if a 
hardware failure occurs and the timer expires, a_ signal is 
generated to indicate that the system has been corrupted. 


This question is always asked. 

If you select this feature, the system you generate will run only 
on a configuration that includes the KW11-Y watchdog timer. If 
you attempt to boot your system on a configuration that does not 
include a KW1l-Y watchdog timer, the system crashes immediately. 


* 13. Memory parity support 


If your system includes parity memory and you want Executive 
support to detect parity errors, enter Yes. 


This question is always asked. 


If you respond No to this question, Target Question 14 (cache 
memory) is not asked. If you respond Yes to this question, SYSGEN 
asks Target Questions 14 and 15. 


* 14. Cache memory 


Cache memory is available on PDP-11/34, 11/60, and 11/70 
processors. 


If your system includes cache memory and you want Executive 
Support to detect parity errors, enter Yes. 


This question is asked only for the processors listed above when 
you select memory parity Support (Target Question 13) for those 
processors. 


*15. Highest interrupt vector (If 0 will be computed) [0:774] 
The response to this question specifies the highest interrupt 
vector address. If you respond 0 (or carriage return) or with a 
value less than 400, SYSGEN calculates this address based on your 
answers to the peripheral questions. 


This question is always asked. 


Enter a value greater than 400 if you require vector space for 
devices that will not be specified during this SYSGEN. 


* 16 


De 
Mn 


emonic 
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SYSGEN does not 
SYSSAVED.DAT 


until you 


NOTE 


write this symbol to 


complete the 


peripheral section. 


- Devices 


This question 
peripherals 


allows you 


and pseudo-devices 


to enter, in mnemonic’ form, 


for your configuration. 


select the appropriate device mnemonic, enter an asterisk (*) 


generate a list 


vice 
Controller (s) 


ADO1-D 

AFC11 

AR11 

CR11 CM11-F 
TA11 TU60 

RPO4 RPO5 RPO6 
TU58 

RF11 

RK11 RKO3 RKO5 
RL11 RLO1 RLO2 
RK611 RKO6 
RP11l RPO2 RPO3 
RMO2 RMO3 

RSO3 RSO4 

TCll1 TUS6 

RX11 RXO1 
RX211/RX02 
VT11 vVT60 

IcS ICR11 
IP11/1IP300 

DRS DSS11l 
LPA11 

LP LS LV11 LA180 
LPS11l 

TU16 TU45 TU78 TE16 
TS04 

TM1l1 TU10 TE10O TSO3 
PC11 

PR11 PCll 
UDC11 

DA11-B 

DL11-E 

DMC11-E 

DP1l 

DQ11 

DU1I1 

DUP11 


of devices. The 
peripheral devices that RSX- 


following 
11M supports: 


Description 


Analog-to-Digital Subsystem 
Low Level Analog Input Subsystem 
Analog Real-Time Module 
Punched Card Reader 

Cassette Drive 

Disk Drive 

DECtape Drive 

Fixed-head Disk Drive 
DECpack Cartridge Disk Drive 
Disk Drive 

Disk Drive 

Disk Drive 

Disk Drive 

Fixed-head Disk Drive 
DECtape Drive 

Floppy Disk System 

Floppy Disk System 

Graphics Display System 
Subsystems 

Subsystems 

Subsystems 

Laboratory Peripheral Accelerator 
Line Printers 

Laboratory Peripheral System 
Tape Drives 

Tape Drive 

Tape Drives 

High-Speed Paper Tape Reader 
High-Speed Paper Tape Punch 
Universal Digital Control Subsystem 
Unibus Link 


Single Asynchronous Serial Line Interface 


Network Link 

Synchronous Line Interface 

NPR Synchronous Line Interface 
Synchronous Line Interface 


Synchronous Line Interface 


To help 


is a list of the 


DETAILS OF SYSGEN PHASE I 


Enter devices in the form: 


device [=controllers] 


where device is the device mnemonic and controllers is the number 
of controllers for the device type. Brackets denote an optional 
entry and are not part of the syntax. If you omit the controller 


entry (=controllers), SYSGEN assumes one controller for 


device type. 


that 


Terminate this question by entering a period(.) either following 


the last controller you enter or on a line by itself. 


Generally, there may be one controller for several devices 


of 


a 


given type. For example, four RKO5 drives can be connected to one 


RK11 controller. In this case, all you are required to. enter 
response to this question is DK; SYSGEN defaults’ to 


controller for all four drives. 


If you make a mistake and specify a device type that is 
included in the target configuration, enter device=0. Also, 


you specify the wrong number of controllers, you can correct 


in 
one 


not 
if 


this 


by reentering; SYSGEN uses the most recent response for duplicate 


entries. For example, if your system includes two 


RK11l 


controllers (four RKO5 drives) and one TCll DECtape controller 
(two TU56 drives), the following sequence corrects an errant 


response of three RKlls, two TU58s, and one RLil. 


Devices: DK=3 
Devices: DT=2 
Devices: DL 
Devices: DK=2 
Devices: DT 
Devices: DL=0 
Devices: e 


NOTE 


To specify the number of paper tape 
device controllers, you must consider 
the number of PCll reader/punch and the 
number of PRl1 readers. Enter’ the 
number of PClls as PP=n, where n is’ the 
number of PCll controllers. Enter the 
number of PR11 controllers as _ PR=k, 
where k is the number of PR1ll 
controllers plus n (the number of PCll 
controllers). For example, if your 
system includes one PCll and two PRIls, 
enter the following: 


PP=] 
PR=3 


5.3 HOST CONFIGURATION QUESTIONS 


This section of questions defines the configuration on which you 
running SYSGEN. 


are 
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* 1. Are you running SYSGEN standalone (on the baseline system) 


This question specifies whether you are running online or a 
standalone. : x 


If you respond Yes, SYSGEN assumes that you cannot spool listings 
and maps and does not ask Host Question 3. 


Note that if you are running SYSGEN online, you cannot direct ie 
listings or maps directly to the line printer (LP:). 


* 2. Is a line printer available 


“4 
This question is asked to allow you to specify the device to which 
maps and listings are sent (line printer if Yes, terminal if No). 
If you respond NO, you cannot specify that the line printer (LP:) 
is the listing device. 
* 3. Spool assembly listings and Executive and driver maps = 


This question allows you to specify whether or not to spool 
listings. For example, you can direct listings to an intermediate 
device. If you want the listings spooled to the line printer 
respond Yes to this question. If you want to save the listings 
but not spool them, respond No to this question. 


* 4, Does the listing/map device have at least 120 columns 


If the listing device does not have at least 120 columns, SYSGEN 
creates a narrow listing file for map listings. For information 
on narrow listings, refer to the descriptions of the /LI switch 
for MACRO-1l and the /WI switch for the Task Builder. 


* 5. Assembly listing file device (ddu:) [Ds "NL:"] 
This question allows you to choose whether or not to direct 
listings to an RSX-11M logical or pseudo device or to not generate 
them at all. 
Specify LP: to send the listings to the line printer if you are —_ 
running standalone, to a disk device (dduu:) if you are running 
online, and NL: (the null device) to direct SYSGEN not to produce 
assembly listings. 
NOTE 
SYSGEN does not load the driver for the 
device you specify. 


* 6. Map device for Executive and device drivers (ddu:) [D: mapdevice] 


The response to this question defines the default device to which Go 
you want to direct the Executive and device driver maps. 


It is recommended that you specify a device for these maps. 
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For unmapped systems, you should specify a device, since the maps 
are required to determine the size of the Executive and to layout 
memory partitions in SYSGEN Phase II. 


Note that you can override the device for driver maps in Phase II. 


5.4 EXECUTIVE QUESTIONS 


This section allows you to choose which of the RSX-11M Executive 
options you want included in your system. 


The RSX-11M/M-PLUS Executive Reference Manual fully describes’ these 


directives and Executive options. 


Answer Yes to the features you want included in your system. 


* 1, Will DBMS-11 be used $DBM 
For details on DBMS-1ll, refer to the DBMS-11 documentation. 


This question appears only if the target processor memory is 
greater than 96K, the system is mapped, and you are not generating 


If you select DBMS-11 support, SYSGEN automatically includes 
Executive support for: Asynchronous System Traps (AST support); 
Memory management directives; and Send/receive by reference 
directives. See Executive questions 16, 6, and 7 respectively. 


* 2. FILES-11 ACP $ a | 


If you do not select Files-11 ACP, none of the services described 


in the IAS/RSX-11]1 I/O Operations Reference Manual are generated in 


your system. 


If DBMS-11 is requested (Executive Question 1) this question is 
not asked. 


DEC-supplied software uses the Files-1ll ACP; it is recommended 
that you select this option. 


You specify the appropriate F1l1lACP for your application during 
SYSGEN Phase II. 


If you are generating an RSX-11S system, this question is bypassed 
and Files-1l ACP is not included in your system. 


tN 


* 3. RMS record locking and placement control 


RMS is the DIGITAL Record Management System. RMS' record locking 
and placement control is a feature of the RSX-11M Record 
Management System and is described in the RMS documentation. 


If you selected Files-11 ACP (Executive Question 2) or if it is 
included in your system by default, this question is asked. 
Otherwise, the question is bypassed and RMS—-1l is not Supported. 
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* 4, Non-resident tasks (task loader) MR 


Non-resident task support allows tasks that are not permanently aa 
resident in your system to be loaded from disk. 


If you do not include support for the task loader, all tasks must 
be installed and fixed into the system image by VMR. 


It is highly recommended that you select this option. 


RSX-11S does not support this option; the question does not 
appear. 


* 5. Loadable task loader ar he (\ 


The RSX-11M task loader reads tasks scheduled for execution from 
disk. Making the task loader loadable is an RSX-11M Executive 
feature that reduces the amount of address space required for’ the 
Executive (excluding pool), freeing space for additional Executive 
dynamic storage, 


we 


If you answer No to this question, the loader is linked into’ the “I 
Executive and requires up to 2400 bytes of Executive virtual 
address space. By making the loader loadable (responding Yes to 
this question), those 2400 bytes become available for use as 
dynamic storage (pool space) or for other Executive features. 
This option is not available on RSX-11S, on unmapped systems, or 
if non-resident task support is not included. 
NOTE a. 


The loadable loader must be loaded by 
VMR at the end of Phase II. 


* 6. Memory management (PLAS) directives rAd MP 


Memory management (PLAS) directives provide functions that allow 
tasks to dynamically modify mapping of their physical addresses in 
memory. These directives also allow tasks to dynamically create 
and delete common blocks. 


The following lists the memory management directives: 


ATTACH REGION 

CREATE ADDRESS WINDOW 
CREATE REGION 

DETACH REGION 

ELIMINATE ADDRESS WINDOW 
GET MAPPING CONTEXT 

MAP ADDRESS WINDOW 
RECEIVE BY REFERENCE 
SEND BY REFERENCE 

UNMAP ADDRESS WINDOW 


Memory management directives are restricted to use on mapped 


systems. Therefore, the question is not asked for unmapped 
systems. 


If you selected DBMS-11l (Executive Question 1) memory management ain, 
directives are included by default and this question is not asked. oe 
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If you select this option, SYSGEN automatically includes support 
for address checking (option 9) and I/O rundown (option 10). 


If you do not select memory management directives, you cannot 
include Executive support for send/receive by reference directives 
(question 7). 


The memory management (or PLAS) directives add approximately 
1000(10) words to the Executive. 


* 7. Send/Receive by reference directives SRR 


The SEND/RECEIVE by reference directives allow one task to send to 
another task a reference to an area within a region. The receiver 
task is given a specified access which allows it to map to or 
delete the region. 


If you selected DBMS support, SYSGEN automatically includes 
Executive support for the send/receive by reference directives; 
this question is not asked. 


If you did not include support for the memory management 
directives, this question is not asked. 


If you did not select DBMS-11, but included memory management 
directives, this question is asked. 


* 8. Get mapping context directive CMC 


This directive returns to the issuing task parameters describing 
the current window-to-region mapping assignments. These 
parameters allow you to restore the mapping context using the 
memory management CREATE ADDRESS WINDOW directive. 


This question appears only if memory management directive support 
was included. 


If you select this feature, Executive Support for address checking 
(option 9) and I/O rundown (option 10) are automatically included. 


* 9. Address checking ReK 


This feature directs the Executive to perform boundary checks, 
alignment checks, and modulus checks on addresses passed by users 
in Executive directives. 


Note that if you are generating a mapped system, address’ checking 
is automatically included; this question is not asked. 


Address checking is recommended unless you are running a 
fully-debugged application system. 


* 10. I/O rundown LOK 


This feature ensures RSX-11M system integrity by cleaning up all 
outstanding task-related I/O before allowing a task to exit. 


It is recommended that you select this feature; I/O rundown is 
recommended unless you are running a fully-debugged application 
system. This feature is automatically included if you are 
generating a mapped system. 
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* 11. Multi-user protection IM eV 


This feature prevents tasks initiated at one terminal from 
interfering with tasks initiated at other terminals. Multi-user 
protection provides for public and private device ownership and 
login and logoff with password protection. 


When you Select this feature, SYSGEN automatically includes’ the 
following terminal driver features: 


Read with special terminator 
Breakthrough write 

Read with no echo 

CTRL/R support 


Select multi-user protection support only if your system has 32K 
or more of main memory. 


Multi-user protection support is not available in an RSX-118 


system; the question 

Multi-user protection 

approximately 100(10) 
* 12. ANSI Magtape ACP 


This feature provides 


is not asked. 


increases the size of the Executive by 
words. 


alae 


support for volume and file labels that 


conform to the ANSI standard for industry-compatible tapes. This 
feature requires Executive AST support; if you select ANSI 
magtape ACP support, SYSGEN automatically includes AST support. 


RSX-11S systems do not Support ANSI magtapes; the question is not 


asked. 


ANSI magtape ACP support increases the size of the Executive by 
approximately 40(10) words. 


OKT? 


* 13. On-line formatting (FMT) or on-line user-mode diagnostics 


On-line formatting or 
Executive and device 


on-line user-mode diagnostics enable _ the 
drivers to perform special I/O functions and 


return additional device status information required by online 


diagnostic tasks, 
RSX-11M/M-PLUS User 


(For information on diagnostic tasks, see the 
Mode Diagnostics Manual and the 


RSX-1] 


Utilities Manual for online formatter (FMT) information.) 


RSX-11S systems do not Support online user mode diagnostics nor 
the FMT task; the question does not appear. 


* 14. Loadable device drivers 


L oy) 


This feature allows you to load and unload most device drivers 
dynamically using MCR and VMR Load and Unload commands. Only the 
industrial and process control device drivers (UDC, ICS/ICR, 
IP11/IP300, and DRS/DSS) and the VT11/VS60 graphics driver are not 


loadable. 


When you select this 


option, SYSGEN generates loadable device 


drivers; however, SYSGEN makes all data bases resident. 


This question is always asked. 


Srey 


” 
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The full duplex terminal driver requires loadable device driver 
Support. Therefore, if you wish to include the full duplex 
terminal driver, you must include loadable driver support. 


* 15. Should the default for all applicable drivers be loadable nee: 


If loadable device driver support is included, this question 
specifies that all drivers (except UDC, ICS/ICR, DRS/DSS, 
IP11/IP300, and VT11/VS60) are to be built as loadable by default 
(you can override the default in the peripheral segtion). If you 
respond No to this question, all drivers (except the full duplex 
terminal driver, if selected) are built as resident. 


The response to this question sets the default, either L 
(loadable) or R (resident) for responses to peripherals questions. 
You can override the default you set with the response to this 
question in your responses to peripherals questions. 


If loadable device driver support is not requested, all drivers 
will be resident, and this question does not appear. 


* 16. AST and cancel selective MARKTIMES A oa ie 


This option allows the processing of Asynchronous System Traps and 
permits you to cancel a single marktime request. 


This feature is automatically included when you select any of the 


following: 

e ANSI magtape ACP support 

e Floating point processor 

e DBMS-11 

e LA driver (LPA11-K) 

e Console logging driver 

e K-series device support routines 


If you exclude this option, the terminal driver cannot support 
unsolicited input character ASTs. 


If you want AST support, but do not need the ability to cancel a 
specific marktime request, enter Yes. You can then edit RSXMC.MAC 
and remove cancel selective mark time support (locate the line 
CSSSMT=0 and delete it). 


* 17. Task: termination and device not ready messages (TKTN) 7 A ) 


This feature directs RSX-11M to automatically generate DEVICE NOT 
READY and task termination messages. 


You must select this option if you want Post Mortem Dump (PMD) and 
Snapshot Dump (SNAP$) support. 


* 18. Power fail recovery $ PRE 


This feature provides for automatic system recovery in the event 
of power failure. Device drivers and tasks that specify a power 
fail AST are notified when power returns. The option is’ required 
to support powerfail ASTs. 
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* 19. Install, request, and remove on exit SLER 


This feature (the MCR Run command) reduces the number of installed 
tasks in memory, thereby optimizing the use of system memory 
resources and minimizing use of pool. Refer to the description of 


the Run command in the RSX-11M/M-PLUS MCR Operations Manual for 


details of the functions provided by this feature. 


This feature is not available for RSX-11S systems. 


* 20. Large (20K) Executive £7aK. 


This feature allows you to generate an Executive larger than 16K 
in order to increase the size of the Executive's virtual address 
space, typically to provide more pool. This reduces to 8K _ the 
maximum size of privileged tasks. 


If you are generating an unmapped system, this question is 
bypassed. 


* 21. Logical device assignment SLED 


This feature (the MCR ASN command) allows you to assign a_ logical 
name to a physical, pseudo, or other logical device. Assignments 
may be made on ae per-terminal (local) or system-wide basis 
(global). 


This option comes to you as highly recommended. 


* 22. Logging of device errors and timeouts S$PTO 


This feature (Error Logging) causes disk and tape device errors to 
be intercepted and status information describing the error to be 
written to a disk file for analysis. When you select this 
feature, checkpointing and the SEND/RECEIVE directives are 
automatically included in your system. 


RSX-11S systems do not support the error logging subsystem; this 
question does not appear. 

* 23. Logging of undefined interrupts SUnt 
This feature directs the Executive to check for traps to undefined 
interrupt vectors and to store information about these traps ina 


disk file for analysis. 


When you select this feature, checkpointing and the SEND/RECEIVE 
directives are automatically included in your system. 


RSX-11S systems do not support the error logging subsystem; this 
question is not asked. 


* 24. Logging of memory parity errors feAe 


This feature directs the Executive to log cache and memory parity 
error traps in a disk file for analysis. 


When you select this feature, SYSGEN automatically includes 
non-resident task support, checkpointing support, and _ the 
send/receive directives. 


; 4 ) 
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This question will only be asked if you specified memory parity 
support. 


RSX-11S systems do not support the error logging subsystem; this 
question is not asked. 


* 25. Do you intend to include a user-written driver LUWD 


User-written drivers can be included in the assembly of the 
Executive. 


If you answer Yes, questions concerning the Executive routines 
SGTWRD (GET WORD) and SPTWRD (PUTWORD) are asked. You will also 
have the opportunity in SYSGEN Phase II, to add a_euser-written 
driver to your Executive. 


* 26. Include routine $GTWRD 


This feature (the SGTWRD Executive routine) is used to obtain a 
word from a user-defined buffer. Refer to the RSX-11M Guide To 
Writing an I/O Driver for information on how this routine is used. 


This question is not asked if you do not intend to include a 
user-written driver. 


* 27. Do you require routine $PTWRD 


This feature (the SPTWRD Executive routine) is used to send a word 


to a user-defined buffer. Refer to the RSX-11M Guide To Writing 
an I/O Driver for information on how this routine is used. 


This question is not asked if you do not intend to include a 
user-written driver. 


* 28. Disk writecheck Puch 


Writecheck support increases the data reliability of disks at the 
cost of a degradation in disk throughput. If selected, writecheck 
may be enabled/disabled dynamically on a per-drive basis via the 
MCR Set command. 


Writecheck is supported for all disks except the RX01, RX02, and 
the RLO1. Disks Supported are: DB, DF, DK, DM, DP, DR, and DS. 


If you specify writecheck support and issue an MCR Set /WCHK 
command in a running system, the driver performs a read after each 
write. If the data cannot be read or does not match the data 
written, the data is rewritten and another read attempt is 
performed. 


RSX-11S does not support disk writecheck; the question does not 
appear. 


DETAILS OF SYSGEN PHASE I 


* 29. Executive Debugging Tool (XDT) TxDT 


The Executive Debugging Tool (XDT) provides a subset of ODT-11 
commands to be used in system state. If selected, XDT is included 
in the Executive. This allows interactive debugging of Executive 


modules, privileged tasks, I/0 drivers, and interrupt service 
routines, 


This feature includes consistency check code in the dynamic memory 
routines. 
* 30. Rotating pattern in data lights <<. €OT 


This feature causes the PDP-11 CPU lights to rotate in a 
pronounced circular pattern when the processor is idle. 


This feature functions only on the 11/45, 11/50, 11/55, and 11/70 
PDP-11 processors. This question appears only for the target 
processors listed above. 


* 31. Industrial network or DECnet $ NET 
This option allows for the inclusion of DECnet or industrial 
network support. Refer to DECnet documentation for details on 
DECnet; refer to Industrial Products documentation 


(IP11/IP300/DPM50 Application Programmer's Manual) for details on 


the industrial network. 
When you select this option, SYSGEN automatically includes: 
e ACP support 
e AST and cancel selective marktime support 
e Logical device assignment support 
e Loadable device driver support 
e Address checking Support 
e Get partition parameters directive support 
e Get task parameters directive support 


e Extend task directive support 


* 32. Queue manager and queued print spooler $PRN 


The queue manager and queued print spooler provide user-controlled 
spooling support for RSX-11M systems. Refer to Appendix D for a 
description of the features of RSX-11M print spoolers. 


If you select this option, the required support is built into’ the 
Executive. If you respond No, you will be asked in Phase II 
whether or not you want to build the serial despooler. 


This question is asked only for mapped systems. 
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*33. Group global event flags £4 6E 


Group global event flags provide each group (in the 


UIC 


specification [group,member]) of system users with 32 (decimal) 
additional event flags. For more information on group. global 


event flags, refer to the RSX-11M/M-PLUS MCR Operations Manual. 


* 34. Enter code for directives ¢D RK 


Use this option to include system directives, as indicated by 
associated letter in the table below. 


Enter * to display table of directives. 
Enter % to include all directives. 
Enter . to terminate the question. 


For descriptions of the directives listed below refer to 
RSX-11M/M-PLUS Executive Reference Manual. 


A- Get partition parms B- Get task parameters 


C- Send/Receive D- Alter priority 
E- Extend task F- Connect to interrupt vector 
G- Get sense switch H- Stop bit 


If you do not select get partition parameters (option A) and 
task parameters (option B), the MCR ASN, ATL, DEV, PAR, TAL, 
TAS commands will not execute correctly. 


the 


the 


get 
and 


If you select DBMS-11 or DECnet support, SYSGEN automatically 
includes Stop Bit, Get Partition Parameters, and Get Task 
Parameters support. Also, the extend task directive is included 


by default. 


If you select ANSI magtape support and error logging support 


for 


device timeouts and parity errors, SYSGEN automatically includes 


Send/Receive support. 


If you select loadable driver support, Connect To Interrupt Vector 


Support is included. 


If you select K-series devices, Connect To Interrupt Vector 


support is included. 


If the target processor does not have a switch register, SYSGEN 


does not allow the inclusion of the Get Sense Switch directive. 


* 35. Number of pre-allocated QIO packets [0:15.:5.] — iV PK 


I/O throughput is enhanced by pre~allocating a number of 


1/0 


packets from the dynamic storage region, leaving them available 


for quick use by Queue I/0. 


The Executive maintains a Last In First Out (LIFO) list of 
preallocated I/0 packets; you specify the maximum size of this 
list with your response to this question. When any I/O packet is 


required, the Executive removes one from this list. If the list 
is empty, the Executive allocates the packet from dynamic memory; 


a Significantly slower operation. When any I/0 packet 
deallocated, the packet is linked into the list, provided that 
list is not full. 


is 
the 
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Thus, in each I/O request, two fast LIFO operations replace’ the 
Slower general pool allocations and deallocations, saving several 
hundred microseconds. Some I/O requests involving an ACP require mm, 
two I/O packets and, therefore benefit twice as much. 


Each I/O packet you preallocate requires 18 words from pool. To 
determine the number of I/O packets to preallocate, consider the 
normal fluctuation in the total number of I/0 requests. The 
fluctuating total number is always smaller than the number of 
outstanding I/O requests. 


Enter a number in the range 0. to 15., indicating the number of 
packets to be pre-allocated. 


The default is 5. 


Enter 0 to exclude pre-allocated QIO packets. 


* 36. Size of data transfer vector in words iD, 


An additional speed improvement is achieved by optimizing data 
transfers in the Executive module BLXIO. One improvement is the 
use of a series of MOV instructions which is used to save time on 
loop control. This is called the data transfer vector. 


Enter a number in the range 5. to 33., to specify the number of 
MOV instructions in the vector. If you enter a value of 16, for 
example, a 36-word data transfer enters the loop control three 
times aS opposed to 36 times if there were only one MOV 
instruction in the vector. 


The default is 33. am, 


This question does not appear for unmapped systems. 


a> 
* 37. Round-robin scheduling interval in ticks mosath nS 


When many competing memory-resident tasks have equal priority, the 
Executive tends to give CPU time more frequently to tasks that 
appear first in the Active Task List (ATL). Entries in the ATL 
with equal priority normally appear in the order in which the 
tasks were installed. AE, 


To avoid this problem, RSX-11M provides the round-robin scheduling 
option. This Executive scheduling algorithm periodically rotates 
(when the specified number of ticks elapses) tasks of equal 
priority within the Active Task List, ensuring that tasks of equal 
priority share CPU time. The overall effect is to evenly 
distribute the use of CPU time, giving each task of equal priority 
time at the head of the Active Task List. 


Round=-robin scheduling refers to the algorithm whereby each task 
of a group of tasks is successively given preference when 
allocating available processor time. The actual algorithm used in 
RSX-11M is to locate the first task within each priority class 
that is not blocked from executing, give it a slice of processor 
time, and when it completes, move that task to the end of its 
respective priority class. Compute-bound tasks tend to actually 
round-robin, whereas I/0O-bound tasks tend to remain at the front 
of their respective priority class. 


'e 
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Round-robin scheduling does not affect the normal competition for 
CPU time of tasks with different priorities. It also does not 
affect tasks not in the range set by the response to SYSGEN Phase 
I Executive questions 38 and 39. 


Round-robin scheduling affects only those tasks in an ATL (in 
memory) that are neither blocked nor in the waitfor state. 


Tasks that are checkpointed or ina partition wait queue are not 
affected. 


Round-robin scheduling costs little in terms of Executive overhead 
(time and size). 


If you do not want this option, enter 0. 


If you want this option, enter a number in the range 1. through 
1000. SYSGEN then asks questions 38 and 39. 


The default is 5. 


* 38. Highest priority class for consideration [1.:249.:150.] ¢. 


Round robin scheduling executes for a specified range of priority 


classes. A typical range is 1. to 150. Permissible range is l. 
to 249, j 


This entry is the highest priority class eligible for round robin 
scheduling. Default is 150. 


This question appears only if you selected the round robin 
scheduling option. 


& 


* 39. Lowest priority class for consideration [l.:high.:1] =| 


This is the lowest priority class eligible for round robin 
scheduling. 


Range is 1. to (highest priority class entered in response to 
question 38). 


Default is l. 


This question appears only if you selected the round robin 
scheduling option. 


* 40. Executive level disk swapping interval [0:5000.:low.:1¢ DA 5 


Disk swapping is an Executive feature that varies the priority of 
memory reSident tasks with the same priority so that those tasks 
can share the use of memory resources. The feature swaps tasks to 
disk based on the swapping algorithm. 


The swapping algorithm creates an "effective" task priority using 
the swapping interval (the response to this question) and the 
Swapping priority (the response to question 41). The swapping 
interval specifies a time parameter, in which the Executive scans 
the partition list and modifies the effective priority of a 
resident task. The swapping priority is an absolute numeric value 
that specifies the range through which a task varies its priority. 
(The range is negative swapping priority through positive swapping 
priority.) 
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The Executive uses a byte in the task header to maintain the 
- swapping priority; symbol SSS$WPR in RSXMC.MAC. The symbol SSSWPR 
is equated to the swapping priority specified in question 4l. 


Each time a task is read into memory, the Executive initializes 

the swapping priority in the task header to the value +SSSWPR (for 

example, +5 if you specify 5 as the swapping priority in question 

41). Then, when the swapping interval expires, the Executive 

decrements the swapping priority of each memory-resident task by . 
one until the task is checkpointed or until the swapping priority 

reaches the minimum value -SS$SWPR (for example, -5). 


After decrementing the swapping priority of each task in _ the 

partition, the Executive determines whether or not an eligible bs 
task on disk can checkpoint a task in the _ partition. The 

Executive compares’ the running priority of the non-resident task 

with the effective priority of the resident task (effective 

priority is the sum of the running priority and the swapping 

priority). If the non-resident task can fit in the resident 

task's space and if, due to the decrementing of swapping priority, 

the priority of the non-resident task is higher, the non-resident 

task can checkpoint the resident task. 


This procedure executes for tasks competing for each main 
partition (except DEVICE and COMMON partitions) and _ for the 
highest priority, non-resident task assigned to each partition. 


If you select this option, SYSGEN automatically includes support 
for checkpointing. 


The permissible range is 0 to 5000. The default is a value that 
is equal to the round robin scheduling interval multiplied by 6. 
If the round robin scheduling interval was 0 (you excluded 
support), this default is 30. 


To disable this option, enter 0. 


* 41. Swapping priority [1:20.:5] ¢ 


The swapping priority determines the range over which lower 


priority tasks may checkpoint higher’ ones; the larger’ the 
swapping priority, the greater the range. With a swapping 
priority of "S", a task running at priority "P" will have an PN 
effective priority range (for checkpointing) from "P+S" to "“P-s" os 


as long as it resides in memory. 


Enter a number in the range 1 to 20. It is recommended that you 
enter the default swapping priority of 5. 


This question is asked only if Executive level disk swapping was 
requested. 

* 42, Size of dynamic storage region in words [256.:16384.:1024.] $DSA 
RSX-11M uses the dynamic storage region (pool) to perform many 


functions. For example, the Executive uses this memory space to w 
process I/O or time-dependent scheduling requests. 7 
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Rather than allocate a fixed amount of memory for each function, 
the RSX-11M Executive makes use of a dynamically allocated memory 
space called the dynamic storage region (DSR). As demands’ for 
space are made, the necessary memory is allocated from this region 
using a first-fit algorithm. When allocated space is no _ longer 
needed, it is released back to the pool of available memory. 


Dynamic memory requirements for a system depend on the 
configuration, application, and degree of system loading. Enough 
memory must be available to satisfy peak demands; otherwise a 
degradation in system performance will occur and the system could 
hang with a DSR deadlock. 


On the other hand, if too much memory is made available, it is 
never used and is thus wasteful of system resources. 


The maximum size of the dynamic. storage region is limited by 
physical memory in an unmapped system. In a mapped system, the 
total size of the Executive, resident drivers, and the dynamic 
storage region must not exceed 16K if you responded No to question 
20 or not exceed 20K if you responded Yes to question 20. 


NOTE 


In a mapped system, the automatic VMR 
process attempts to allocate as much 
pool as possible (up to the maximum 
Executive size). If you do not edit the 
command file (SYSVMR.CMD) that performs 
this, the response to this question is 
not critical. 


The following list specifies some RSX-11M functions that use 
dynamic memory. Use this list to calculate how much memory you 
should allocate. 


Tasks; Each task installed in the system requires at least 20 
words for a task control block. 


I/O Requests: Each I/O request results in the allocation of an 
18-word I/0 packet, which is queued to the appropriate device 
driver. 


SEND DATA and SEND BY REFERENCE Message: Each Send Data or _ Send 
by Reference message sent to a task results in an 18-word 
message packet being allocated to hold the requisite data. 


Partitions and Subpartitions: Each main partition and 
Subpartition reguires a partition control block of at least 14 
words to describe its memory. In addition, for each active 
task, fixed task, and loaded driver in a system-controlled 
partition, (whether the tasks are checkpointed or in memory) a 
PCB is built and allocated in the dynamic storage region. 
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Open Files: Each open file requires 18 words for a file control 
block and 18 words for a window block which contains 
virtual-to-logical block mapping pointers. 


The file system ACP (F11ACP) may be built to store File 
Control blocks in its own task image rather than in dynamic 
storage region. (See details of SYSGEN Phase II.) The more 
space allocated at task build time, the less the demand will 
be on the pool. However, if the allocated space becomes’ used 
up, the overflow will use the dynamic storage region. 


Mounted Volumes: Each mounted volume requires 18 words for a 
volume control: block, 18 words for the index file window 
block, and 18 words for the index file control block. In 
addition, three 18-word control blocks are required to hold 
information pertaining to the last three directory files that 
were accessed. For systems that contain I/O optimization, MOU 
will try to allocate a window block for the index file of 
sufficient size to contain all of the retrieval pointers. 
This could require up to 208 words. If the space is not 
available, MOU will default to 18 words. Space-saving hint: 
The directory least-recently-used (LRU) table default is three 
18-word file control blocks. The effect of this table is a 
significant increase in the speed of directory operations. If 
this level of performance is not required, a volume may be 
mounted using the /LRU keyword, thereby reducing the number of 
FCBs used. 


Clock Queue Entries: Each clock queue entry requires eight words. 
These entities represent mark time, schedule, and periodic 
scheduling requests. 


AST-Related Processing: Each powerfail, receive, and floating 
point processor AST trap-enable for active tasks requires 
eight words for an AST control block. 


I/O Buffers: All terminal output is buffered in the terminal 
driver before transferring information to the user buffer. 
Each solicited and unsolicited input request requires a 
42-word input buffer. 


Card Images: Card images read from the CM/CRl1l are buffered by 
the card reader driver before transferring the translated 
information to the user buffer. Binary output requires an 
80-word buffer, whereas ASCII input requires a 4-word buffer. 


LPS11 and AR11 Synchronous Functions: Each LPS11/AR11 synchronous 
function requires 20 words for a sample control block. 


Task Headers: In a mapped system, the task header is copied into 
a block of memory allocated from the dynamic storage region. 
Approximately 64 words (dependent upon the number of LUNS- and 
window blocks) are required for each task that is in memory 
(i.e, in execution and not checkpointed, or inactive and 
fixed). 


Task Linked to ICS/ICR-11 Interrupts: Each task linked to 
ICS/ICR-11 interrupts requires 16 words of dynamic memory, 
plus six words for each interrupt linkage. 


Data Bases for Loadable Drivers: Data bases that are loaded into 
a system with a loadable driver require space equal to the 
size of the data base. 
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Loadable Drivers: Loaded drivers on a mapped system require space 
for interrupt linkage as follows: 


e 14 words per interrupt entry for single-controller, 
non-error-logging drivers 


@e@ 22 words per interrupt entry for Multi-controller, 
non-error-logging drivers 


e 14 words for the first (or only) interrupt entry for 
error-logging drivers, plus 6 words for each additional 
interrupt entry for error-logging drivers 


Checkpointing: Systems with dynamic checkpoint space allocation 
require 8 words to describe each checkpoint file and 8 words 
for each task checkpointed to a checkpoint file. 


Memory Management Directives: Systems supporting the memory 
Management directives require 6 words per task (active or 
fixed) for each region a task is attached to. This includes 
the task region and all static and dynamic commons. 


Connect to Interrupt: Systems supporting the connect to interrupt 
directive require 22 words for each Interrupt Transfer Block 
(ITB) used for each interrupt vector serviced by a 
connect-to-interrupt directive. 


Error Logging: Variable-length packets are allocated for each 
logged error which has not been serviced by the error logger. 


(See the RSX-11M/M-PLUS Error Logging Reference Manual.) 


After you calculate the size of the DSR, add approximately 12-18 
percent to cover possible pool fragmentation conditions. 


‘Note that you can later extend this initial allocation using the 
MCR Set /POOL command. 


This entry must be in multiples of two words. The permissible 
range of entries is 256. to 16384. 


The default is 1024. 


* 43. Seconds between printer not ready messages [0:255.:30.)]4 PNIR 


This question is asked if a line printer was specified in the 
peripheral configuration and you included TKTN support (the TKTN 
task prints the message). 


Specify the number of seconds between printer not ready messages. 
An entry of 0 suppresses the messages altogether. 


The default is 30. If you make a non-zero entry, the minimum 
value of this entry is 15. 

* 44, Seconds between card reader not ready messages [0:255.:30.] 
This question is asked if a card reader was specified in the 
peripheral configuration and you included TKTN support (the TKTN 


task prints the message). 


Specify the number of seconds between card reader not ready 
messages. An entry of zero suppresses the messages altogether. 
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The default is 15. 


If you enter a non-zero value, the minimum value of the entry is 


15. 
* 45. System crash register and stack dump device CSR 
(0:177700:177564) kSD 


If the system crashes and this option is included, the Executive 
stack and registers are dumped to the selected device. 


Enter the CSR address of the device. The normal device is’ the 
console terminal, which has a CSR address of 177564. This is the 
default device. 


Enter 0 to suppress this option. 


If you enter a non-zero value, it must be in the range 160000 to 
177700. 


* 46. Checkpointing: A- Yes B- With system checkpoint file aK 


Checkpointing allows the Executive to displace tasks from a 
partition to yield memory to tasks of higher priority. 


The goal of checkpointing is to avoid preempting the execution of 
lower-priority tasks unless a higher-priority task can make use of 
the memory resources allocated to the lower-priority task. This 
optimizes the use of processor memory while maintaining a priority 
scheduling algorithm. 


In some cases, an activated task cannot execute because’ the 
partition in which the task must execute is occupied. 


If the partition is occupied by a task (TASKA, for example) that 
is both checkpointable and has a priority lower than the task that 
is waiting (TASKB, for example), the Executive may move the task 
with the lower priority (TASKA) to disk, thus making room for the 
higher priority task (TASKB) waiting on disk. 


When the higher priority task (TASKB) is stopped or allows its 
priority to be lowered, the lower priority task (TASKA) on disk 
may be moved back into memory to continue execution. 


This task (TASKA) continues execution from the point at which it 
was interrupted. 


RSX-11M supports checkpointing in both user-controlled partitions 
and system-controlled partitions. 


Enter A if you want checkpointing. (SYSGEN automatically includes 
checkpointing if you selected Executive level disk swapping.) 


Enter B if you want checkpointing with a system checkpoint file. 
Selection of this (B) option allows checkpointing into a system 
checkpoint file rather than requiring space in each checkpointable 
task image. 


Enter carriage return to exclude this feature. 
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If you select checkpointing with a system checkpoint file (B), you 
must allocate space for the file when you start up the system, for 
example, in STARTUP.CMD. Refer to the RSX-11M/M-PLUS MCR 
Operations Manual for more information. 


Note that if you exclude checkpointing Support, the terminal 
driver cannot support task checkpointing during terminal input. 


This option does not apply to RSX-11S systems; the question is 
omitted. 


* 47. System-controlled partitions: A-Yes B-Yes With auto compaction 
(SHF) 


This option allows as many tasks as will fit into a partition to 
be simultaneously resident. The allocation of partition memory is 
automatic and is carried out by the RSX-11M Executive dynamically. 


Enter A if you want system-controlled partitions. 


Enter B if you want system-controlled partitions with automatic 
compaction (the Shuffler task). 


When the Executive determines that there is insufficient memory to 
load a waiting task into a system-controlled partition, the 
shuffler executes (following an allocation failure during an 
attempt to allocate memory from a system-controlled partition). 


The shuffler scans Partition Control Blocks searching for a 
system-controlled partition which has at least one eligible task 
waiting for memory. When such a partition is found, the shuffler 
attempts to compact the memory partition and thus form a 
contiguous space large enough to contain the waiting task. 


The shuffler algorithm consists of two passes through each 
system-controlled partition. 


In the first pass, the shuffler unconditionally checkpoints all 
stopped, checkpointable tasks. (This includes all tasks stopped 
for terminal input if you select option 5 in the terminal driver 
section of Phase 1.) The shuffler then starts at the beginning of 
the system-controlled partition and tries to move (shuffle) all 
tasks that are positioned above a gap of free space down to the 
base of the free space. When the shuffler completes its first 
pass, all stopped, checkpointable tasks are checkpointed and all 
free space in the system-controlled partition has been merged into 
one hole at the top of the partition. (However, there may be 
additional holes below these tasks that cannot be shuffled.) 


If the shuffler completes its first pass and some eligible tasks 
are still waiting for space in the partition, the shuffler 
executes its second pass. In the second pass, the shuffler 
creates an ascending, priority-ordered list of the tasks in the 
partition. It then uses this list to determine if the size of the 
waiting task is less than the sum of the free space and the size 
of one or more of the lower priority, checkpointable tasks. Lf; 
and only if, the size of the waiting task is less than this sum, 
the lower priority tasks are checkpointed. 


Unmapped systems do not support system-controlled partitions. 
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If you select DBMS-11l, this feature (A) is included by default. 
However, the shuffler (B) is not; if you want the shuffler, you 


must select it. am, 
This option does not apply to RSX-11S systems; SYSGEN omits the 
question. 
/ i 
* 48, Dump Analysis: A- PANIC B- Crash (CDA) q \ , 


If the dump routine option is omitted and a system failure occurs, 

it may not be possible for the user to capture vital data on the 

state of the system at failure time. The RSX-11M Guide to Writing : 
an _I/0 Driver describes the PANIC dump routine. The CDA crash 
dump routine is normally used in debugging new drivers or 

privileged tasks after the drivers or tasks crash the system. It 

provides a means of generating a formatted dump of memory on a 

line printer or a terminal. For more detailed information, refer 


to the RSX-11M/M-PLUS Crash Dump Analyzer Reference Manual. 


Enter A if you want the panic dump routine 
Enter B if you want crash dump analysis (CDA) support am 
If you select B, SYSGEN asks Executive Questions 49, 50, 51, and 
52. 
* 49. Output notification device CSR [160000:177700:177564] Vay 
This question appears if you selected B (crash dump support). 


Enter the CSR of the device to which the crash notification is to 
be output. Typically, this will be the console device (177564). 


eo 
* 50. Memory dump device (ddu:) [3:4] NINA 


This question appears only if crash dump analysis (CDA) support 
was selected. 


Enter the mnemonic and unit number of the device on which you want 

a memory dump. Note that the memory dump device must be part of 

the target hardware configuration, but not necessarily generated me 
into the target system. Supported devices are DT, DK, MT, MS, MM, aia 
DB, DM, DL, DD, and DR. 


Avoid, if possible, using your system device as the crash dump 
device. 
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* 51. CSR address of dump device [160000:177700:default] 


Enter the CSR address of the dump device. The default depends 
the type of device you specify as the crash dump device: 


Device Default 
Type CSR 
DT 177342 
DK 177404 
MT 172522 
MM 172440 
DB 176700 
DL 174400 
DM 177440 
DR 176700 
DD 175600 
MS 172522 


* 52. CSR address of PANIC dump device [160000:17700:177564] 


on 


If panic dump was selected, enter the CSR address of the indicated 


panic dump device. Normally, this is the CSR address of 
console device, which is also the default. 


This device must be a paper tape, terminal, or 


the 


line 


printer-compatible device. The device must receive a single byte 


at a time. 


This question is asked only when you request panic dump support 


(option A in Executive Question 48). 


5.5 TERMINAL DRIVER QUESTIONS 


This section allows you to choose which of the RSX-11M terminal 
drivers you want as part of your system. The section also allows you 


to specify terminal driver options. 


Terminal driver options are described fully in the RSX-11M/M-PLUS 
Drivers Reference Manual. 


Answer Yes to the options you want included in your system. 


* 1, Terminal driver desired (A/B/C/D, * prints table) 


I/O 


This question allows you to select the terminal driver you want to 
include in your system. RSX-11M systems use one of two terminal 


drivers: 
e Half duplex (baseline, no options; tailorable, you select 
options; and tailored, user-oriented options included by 
default) 


e Full duplex 


Enter A to select the half duplex terminal driver that you tailor 


(specify specific options) to meet the needs of your system. 
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Enter B to select the user-oriented half duplex terminal driver. 
The user-oriented driver includes the following options: 

e Automatic carriage return/line feed (option 4) 

e Task checkpointable during terminal input (option 5). Note 
that Lif you did not include Executive support for 
checkpointing, this option is excluded when you select’ the 
user-oriented terminal driver. 

@e Unsolicited input character AST (option 6). Note that this 
option requires Executive AST support. Therefore, if you did 
not include Executive AST support, this option is excluded 
when you select the user-oriented terminal driver. 

e Write with CTRL/O cancellation (option 7) 

e Breakthrough write (option 8) 

e cCTRL/R retype (option 9) 

e Get multiple characteristics (option 11) 

e Get terminal driver options (option 13) 

e Transparent read/write (option 15) 

e Settable case conversion for input (option 16) 

e Read after prompt (option 17) 

e Read with no echo (option 18) 

e Read with special terminator (option 19) 

@ CRT rubout support (option 20) 

e Terminal-host synchronization (option 21) 

e Variable length terminal input buffering (option 23) 

If you want more or fewer options with the half duplex terminal 
driver, you should select the tailorable half duplex terminal 
driver (enter A). 

Enter C to select the full duplex terminal driver. This driver 
requires a mapped system and loadable driver support. The full 
duplex driver includes the following options: 

e Passes form feeds directly to the terminal (option 3) 

e Automatic carriage return/line feed (option 4) A 

e Task checkpointable during terminal input (option 5). Note 
that this option requires Executive support for checkpointing. 
Therefore, if you did not include checkpointing support, this 
option is excluded when you select the full duplex terminal 
driver. 

e Unsolicited input character AST (option 6). Note that this 
option requires Executive AST support. Therefore, if you did 


not include Executive AST support, this option is excluded 
from the full duplex driver. 
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e Write with CTRL/O cancellation (option 7) 


e Hold screen mode (option 14) 


e Transparent read/write (option 15) 


e Settable case conversion for input (option 16) 


e Read with no echo (option 18) 


e Read with special terminator (option 19) 


e Terminal-host synchronization (option 21) 


e User terminal input buffering (option 22) 


e Variable length terminal input buffering (option 23) 


e  LA30P support (option 24) 


e Hardware unrecoverable input error Support (option 25) 


e Device independent cursor positioning (option 26) 


Enter D to select the baseline terminal driver. 


driver 


Note that 
and a multiuser protection system are mutually exclusive. 
The baseline driver is a minimum half duplex terminal driver 
no SYSGEN options. 


* 2. Unsolicited input timeout value in secsmaa 


This option is available with the full duplex ter 
only; the question does not appear if you responded A, B, or D to 
question l. 


The full duplex driver discards unsolicited 


expiration of the timeout value that you specify. 
range is 0 to 2540 seconds. 


Enter 0O 


to inhibit the full duplex terminal 


input timeout feature. 


driver 


Enter carriage return (the default timeout: value is 
or specify the number of seconds (in the range 1 to 2540) to wait 
to timeout on unsolicited terminal input. 


* 3. Pass form feeds directly to the terminal 


This question appears only if you responded A or B to 
(selected the tailorable or pre-tailored half duplex terminal 


driver). 


this 


with 


minal driver 


input upon 


the 


Valid timeout 


unsolicited 


120 seconds) 


question 1 


The half duplex driver normally converts a form feed into 8 


feeds. 


Enter Yes to suppress this conversion. 


line 
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NOTE 


If your system includes an LA120 or an 
LA180S terminal, you must respond Yes to 
this question and include the option. 


This option adds approximately 24(10) words to the terminal 
driver. 


* 4. Automatic carriage return/line feed 


This question appears only if you responded A to question 1 
(selected the tailorable half duplex terminal driver); the 
user-oriented driver and the full duplex driver include the option 
by default. 


If you respond Yes to this option (or if the option is included by 
default), the terminal driver generates a carriage return and line 
feed when the terminal buffer is filled on output or echo. (You 
can examine or alter terminal buffer size with the MCR Set /BUF 
command.) This option adds approximately 70(10) words to the 
terminal driver. 


* 5. Task checkpointable during terminal input 
This question is omitted if you responded with C to question 1; 
the full duplex driver includes the option automatically. Also, 
since a response of B to question 1 selects a pre-tailored half 


duplex driver, this question does not appear. 


The question appears only if your response to question 1 was A and 
you included Executive support for checkpointing. 


If you select this option, checkpointable tasks can be displaced 


from memory during terminal input by another task. This option 
adds approximately 110(10) words to the terminal driver. 


NOTE 


This option can only be included in 
systems that contain Executive support 
for checkpointable tasks. 


* 6. Unsolicited input character AST 


This question appears only if you responded A to question 1 = and 


included Executive support for ASTs; when possible, the 
user-oriented and full duplex drivers include the option by 
default. 


If you select this option, a task that attaches to a terminal can 
specify an AST entry point upon receiving unsolicited input from a 
terminal (for example, CTRL/C gains the task's attention rather 
than MCR). This option adds approximately 160(10) words to the 
full duplex terminal driver and approximately wOneG) words to. the 
half duplex terminal driver. 
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NOTE 


This option requires Executive AST 
support. 


* 7. Write with CTRL/O cancellation 


This question appears only if you responded A to question l. 


If you select this option, a task that issues a write request with 
CTRL/O cancellation can print to the terminal when the target 
terminal has suppressed output with CTRL/O. This option adds 
approximately 16(10) words to the terminal driver. 


* 8. Breakthrough write 


This question appears if you responded A or C to question 1. If 
you selected multiuser protection support, SYSGEN automatically 
includes this option. 


If you select this option, a privileged task that issues a 
breakthrough write request can print to a terminal regardless of 
current or outstanding I/O activity. This option adds 
approximately 96(10) words to the full duplex terminal driver and 
approximately 245(10) words to the half duplex terminal driver. 


NOTE 


When you select this option, SYSGEN 
automatically includes terminal driver 
support for the CTRL/R retype option 
(option 9). Together, these two options 
add approximately 160(10) words to the 
full duplex terminal driver and 
approximately 275(10) words to the half 
duplex terminal driver. 


* 9. CTRL/R retype 


This question appears if you responded A or C to question 1 and 
did not select the breakthrough write option (option 8). 


If you select this option, the terminal driver sends a carriage 
return/line feed followed by the contents of the input buffer 
whenever you type CTRL/R at the terminal. This option adds 
approximately 64(10) words to the full duplex terminal driver and 
approximately 32(10) words to the half duplex terminal driver. 


ae / 
* 10. Escape sequence handling te 5 eZ 


This question appears if you responded A or C to question l. 


If you select this option, the terminal driver recognizes’ and 
treats escape sequences as line terminators for all solicited 
input except read-pass-all or read-with-special-terminator 
requests. This option adds approximately 128(10) words to the 
full duplex terminal driver and approximately 160(10) words to the 
half duplex terminal driver. 


* 12. Set multiple characteristics Ee [7 eg 


i AR 
* 13. Get terminal driver options Loy | & 
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a 
* 11. Get multiple characteristics [V\ _ C 


This question appears if you responded A or C to question l. 


If you select this option, a task can determine physical 
characteristics (for example, CRT, VT52, slaved, or VT100) of 
individual terminals. The task RMDEMO makes use of this option, 
for example. This option adds approximately 96(10) words to the 
full duplex terminal driver and approximately 110(10) words to the 
half duplex terminal driver. 


This question appears if you responded A or C to question l. 


If you select this option, a task can set or reset physical 
characteristics (for example, CRT, VT52, slaved, or VT100) of its 
TI: terminal. A privileged task can use this option to. set 
physical characteristics of any terminal in the system. This 
option adds approximately 256(10) words to the terminal driver. 


a 


This question appears if you responded A or C to question l. 


If you select this option, a task can determine which of the 
terminal driver options were selected during system generation. 
This option adds approximately 32(10) words to the full duplex 
terminal driver and approximately 64(10) words to the half duplex 
terminal driver. 


14. Hold screen mode 
This question appears only if you responded A to question l. 


If you select this option and your terminal(s) include special 
hardware, the terminals can break stream output into pages that 


fit on the screen. (Note that an unsolicited CTRL/C disables hold 
screen mode.) 


NOTE 


When you select this option, SYSGEN 
automatically includes terminal driver 
support for the transparent read/write 
option (option 15). 


This option adds approximately 92(10) words to the terminal 
driver. 


* 15. Transparent read/write 


This question appears only if you responded A to question 1 and 
did not include the hold screen option (option 14). 


The terminal driver normally filters terminal input on both input 
and output. This permits the recognition of control characters 
that have special meaning (for example, escape) or require fill 
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characters (for example, carriage return). If you select this 
option, the terminal driver provides support for I/0 functions 
(IO.RAL and IO.WAL) that bypass character filtering and permits 
output of to 32K bytes. This option adds approximately 48(10) 
words to the terminal driver. 


* 16. Settable case conversion for input 
This question appears only if you responded A to question l. 


The terminal driver normally accepts and echoes characters as 
received. If you select this option, you can selectively enable 
(using the MCR Set /LOWER- command) so that the driver 
automatically converts lower case input to upper case. This 
option also allows the terminal driver to recognize the brace 
character (175) and the tilde character (176) as ASCII characters 
rather than a form of escape when the terminal is set to lower 
case. This option adds approximately 30(10) words to the terminal 
driver. 


* 17. Read after prompt k AP 
This question appears if you responded A or C to question l. 


If you select this option, a read after prompt request acts like a 
write to the terminal followed by a read. This reduces the 
overhead of one I/O request and eliminates context switching. 
Also, this option removes the execution window, provided the 
terminal is not attached, by which one task can prompt and another 
task initiate terminal I/O before the first task (the prompting 
task) had time to issue its read request. This option adds 
approximately 128(10) words to the full duplex terminal driver and 
approximately 185(10) words to the half duplex terminal driver. 


* 18. Read with no echo 


This question appears only if you responded A to question 1 and 


did not include multi-user protection support. (Multi-user 
protection support automatically includes this terminal driver 
option.) 


If you select this option, you can issue the read _ functions 
IO.RLB, I0O.RVB, and I0O.RPR and specify that the driver not echo 
terminal input. This option adds approximately 48(10) words’ to 
the terminal driver. 


* 19, Read with special terminator 


This question appears only if you responded A to question 1 and 


did not include multi-user protection support. (Multi-user 
protection support automatically includes this terminal driver 
option.) 

The line terminators for a normal read are carriage return or 
escape. If you select this option, any character less than 40 
octal or greater than 174 octal can terminate a read with special 
terminator request. However, escape sequences cannot be 


recognized in this mode. Also, note that if the terminal is set 
to lower case, only 177 octal and characters less than 40 octal 
can act as terminators. This option adds approximately 45(10) 
words to the terminal driver. 
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* 20. CRT rubout support Cis 


This question appears if you responded A or C to question l. am 


If you select this option, the terminal driver echoes rubouts or 
deletes on a CRT terminal as backspace-space-backspace; 
effectively, this option erases the character from the CRT screen 
when you type rubout or delete. This option adds approximately 
64(10) words to the terminal driver. ° 


* 21. Terminal-host synchronization 
This question appears if you responded A to question l. 4 


If you select this option, you can start and stop terminal output 
by typing CTRL/S (to stop) and CTRL/Q (to start). This option is 
useful for high speed display terminals. 


NOTE 


If your system includes a VT50 terminal 
with the copier option, you must respond 
Yes to this question and include the 
option. 


This option adds approximately 84(10) words to the terminal 
driver. 


* 22. User terminal input buffering 


This question appears only if you responded A to question l. 


The terminal driver normally receives characters and stores’ the 
characters in the Executive address space until receiving a line 
terminator. Upon receiving a line terminator, the driver copies 
the contents of the buffer into the requesting task's input 
buffer. If you select this option, the driver, provided that the 
task is not checkpointable, places the input characters directly 
into the task buffer as the characters are received. This option 
adds approximately 12(10) words to the terminal driver. 


* 23. Variable length terminal input buffering 
This question appears only if you responded A to question 1. 


Normally, terminal driver input buffers are 80 bytes long, which 
implicitly limits the maximum size of a terminal input request as 
well as the size of the minimum buffer allocation from dynamic 
memory. If you select this option, the terminal allocates buffers * 
large enough to satisfy the read request. The largest buffer can 


be 255 bytes long. This option adds approximately 24(10) words to 
the terminal driver. 


a ee eo ee 
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* 24, LA30P support 


This question appears only if you responded A to question l. 


The LA30P DECwriter connects to the processor via aé_e single 
buffered interface. If you do not select this option, the second 


of two rapidly typed characters may be discarded by the terminal 
driver. 


NOTE 


Choose this option only if your system 
includes an LA30P terminal; the 
terminal driver properly supports all 
other combinations of DEC terminals and 
interfaces. 


This option adds approximately 48(10) words to the terminal 
driver. 


* 25. Hardware unrecoverable input error notification HK Ee 
This question appears only if you responded C to question l. 


If you select this option, the full duplex terminal driver detects 
and flags framing errors, character parity errors, and data 
overruns and then passes the input character(s) to the requesting 
task with notification (including type) of an input error. If you 
do not select this option, the driver discards hard receive 
errors. This option adds approximately 32(10) words’ to the 
terminal driver. 


* 26. Device independent cursor positioning V | Cc 
This question appears only if you responded C to question l. 


If you select this option, the full duplex terminal driver 
supports terminal independent cursor positioning commands. When 
you specify a cursor positioning character, the driver outputs a 
cursor positioning character string before it outputs the buffer. 


This option adds approximately 192(10) words to the terminal 
driver. 


5.6 PERIPHERAL QUESTIONS 


This section of questions describe the peripheral devices included in 
your target configuration. The questions define unique hardware and 
software information that RSX-11M uses to communicate with peripheral 
devices. SYSGEN generates questions only for those devices you 
specified in response to target configuration question 16. 


During this section, you enter device-dependent parameters which 
define addressing information as well as special attributes for the 
peripheral devices. SYSGEN displays a prompt line that describes the 
required parameters and then a specific device question, which 
includes any default values for the parameters. 
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If you selected loadable driver support, the general form of a SYSGEN 
prompt is: 


Enter [L/R,] parameterl, parameter2,...parametern for: 


where: 


L/R is an optional parameter that specifies whether’ the 
driver is loadable (L) or resident. Note that you 
specified the default value for this parameter in your 
response to Executive question 15. If your response to 
question 15 was No, all drivers are resident unless you 
override the default by specifying L. Likewise, if 
your response to question 15 was Yes, all drivers are 
loadable unless you override the default by specifying 
R. 


The process control drivers (UDC, ICS/ICR, IP11/IP300 
and DRS/DSS drivers) and the VT11/VS60 graphics driver 
are not loadable; this parameter does not appear for 
these drivers since they are always resident. 


The full duplex terminal driver is always loadable; 
this parameter does not appear’ for the full duplex 
terminal driver. 


If you override the default (specify an L or an R), you 
must terminate this parameter with a comma (,), even if 
it is the only parameter on the line. 


parameter is a device dependent parameter (parameters 1 through 
n). 


If you did not select loadable driver support, the general form of a 
SYSGEN prompt is: 


Enter parameterl, parameter2,...parametern for: 
where parameters 1, 2, through n are device dependent parameters. 


In the SYSGEN prompts, parameters enclosed in brackets ({]) are 
permitted only in the response for the first controller. Parameters 
enclosed in parenthesis (()) are required only if the indicated option 
is present in the target system. 


Some devices require common parameters. To display the specific 
device question, SYSGEN groups the devices that require common 
parameters together and then shares the respective SYSGEN prompt line. 
Table 5-1 lists all the SYSGEN prompt lines and the devices that use 
each. 


The device specific questions display default values for the 
parameters listed in the SYSGEN prompt line. When the question does 
not display a parameter, you must enter a value for that parameter. A 
comma (,) is the parameter delimiter. Note that blanks or tabs are 
not permitted between parameters. 


When you specify a required parameter or override the default value, 
SYSGEN applies a minimum and maximum range (the acceptable range) for 
each parameter. If the value you enter is not within the acceptable 
range, SYSGEN issues an error message that identifies the parameter by 
number, according to its position in the prompt line. Note that if 
your system includes loadable driver support, the optional L/R 
parameter is not included in the parameter count. For example, if you 
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enter 300 as the CSR address for a CR1l1l controller (SYSGEN prompt 1), 
SYSGEN displays: 


SGN -- Parameter (#2) "300" out of range 160000 to 177700 -- RETRY 


and then repeats the question. The number in parenthesis is. the 
parameter count (excluding L/R if applicable) and the value in quotes 
is the invalid parameter. 


CAUTION 


When you enter a numeric response, do 
not include a period (to specify 
decimal) or a pound sign (to specify 
octal). This will cause an error; 
SYSGEN attempts to validate your 
response and does not permit explicit 
decimal or octal entries. 


Enter numeric values within the 
acceptable range. SYSGEN interprets the 
response to be octal or decimal as 
required. 


Refer to the detailed description if you 
are unsure of the base for a specific 
numeric response. 


Table 5-1 
SYSGEN Prompt Lines 


Enter [L/R,] vector, CSR for: 


Devices that use this prompt are (group 1 devices): CR11 card 
reader (CR:), TAl1l cassette (CT:), RF disks (DF:), TSO4 magtape 
(MS:), PCll paper tape punch (PP:), PC11/PR11 paper tape reader 
(PR:),  UDC11l universal digital controller (UD:), DA1l parallel 
line interface (XB:) 


Enter [L/R,] vector, CSR, number of drives, unit number of first drive, 
[O=offset recovery support/NO=no support] for: 

Devices that use this prompt are (group 2 devices): RP04/05/06 
disk packs (DB:), RMO2/03 disks (DR:) 

Enter [L/R,] vector, CSR, number of drives for: 
Devices that use this prompt are (group 3 devices): TU58 DECtape 
II (DD:), RLO1 cartridge disks (DL:), RP02/03 disks (DP:), TCll 
DECtape (DT:), RX0l1 floppy disk (DX:), RX02 floppy disk (DY:), 
TU45/TU16/TE16/TU77 magtapes (MM:), TSO3/TU1O/TE10 magtapes (MT:) 


(continued on next page) 
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Table 5-1 (Cont.) 
SYSGEN Prompt Lines 


Enter [L/R,] vector, CSR, F=full duplex/H=half duplex, 
E=error detec. unit/NO=no, C=char. detec. unit/NO=no, 
number of sync characters in leader for: 
Devices that use this prompt are (group 4 devices): DQl1l 
synchronous line interface (xXQ:) 

Enter [L/R,] vector, CSR, number of drives, unit number of first drive 
Devices that use this prompt are (group 5 devices): RS03/04 
disks (DS:) 

Enter [L/R,] vector, CSR, highest unit number <0 to 7> for: 

Devices that use this prompt are (group 6 devices): RKO5 
cartridge disks (DK:) 

Enter vector, CSR, VT11/VS60, number of CRT monitors for: 

Devices that use this prompt are (group 7 devices): VT11/VS60 
graphics display.processor and scope (GR:) 

Enter [L/R,] CSR, number. of A/D channels for: 

Devices that use this prompt are (group 8 devices): ADO1 
analog-to-digital converter (AD:) 

Enter [L/R,] vector, CSR, number of A/D channels for: 

Devices that use this prompt are (group 9 devices): AFC1ll 


analog-to-digital converter (AF:;) 


Enter [L/R,] clock vector, CSR, polarity mask, D=D/A channel/NO=no, 
maximum number of samples/second, DRK=DR11-K/NO=no, 
(,DR11-K CSR) for: 


Devices that use this prompt are (group 10 devices): AR11 
laboratory peripheral system (AR:) 


for: 


Enter [L/R,] clock vector, CSR, #A/D channels, G=gain ranging option /NO=no, 


polarity mask, bandwith filter channel select delay, 
number of D/A channels, D=digital I/O option/NO=no, 
maximum number of samples/second for: 


Devices that use this prompt are (group 11 devices): LPS1l 
laboratory peripheral system (LS:) 


(continued on next page) 
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Table 5-1 (Cont.) 
SYSGEN Prompt Lines 

Enter [L/R,] vector, CSR (, number of UMRsS) for: 

Devices that use this prompt are (group 12 devices): LPA11-K 
laboratory peripheral accelerator (LA:) 

Enter [L/R,] vector, CSR, #drives, O=offset recovery/NO=no offset rec. for: 
Devices that use this prompt are (group 13 devices): RK06/07 
cartridge disks (DM:) 

Enter [L/R,] vector, CSR, F=full duplex/H=half duplex 

number of characters in sync leader for: 
Devices that use this prompt are (group 14 devices): DL11-E 
asynchronous line interface (XL:), DP1l synchronous” line 
interface (XP:), DU11l synchronous line interface (XU:), DUP11 
synchronous line interface (XW:) 

Enter [L/R,] vector, CSR, F=full duplex/H=half duplex/P=primary HDX for: 
Devices that use this prompt are (group 15 devices): DMC 


interprocessor link (XM:) 


Enter [L/R,] vector, CSR, printer type 
(, (KMC timeout count <0=no KMC>, KMC vector, KMC CSR]) for: 


Devices that use this prompt are (group 16 devices): 
LA1L80/LS11/LP11/LV11 line printers (LP:) 

Enter number of modules, module number of first for: 
Devices that use this prompt are (group 17 devices): UDC ADUO] 
analog input module, UDC analog output module, UDC bi-stable 


output module, UDC digital interrupt module, UDC digital sense 
module, UDC I/0. counter module, UDC single-shot output module 


(all UD:) 

Enter [L/R,] terminal number to redirect to (TTn:) for: 
Devices that use this prompt are (group 18 devices): Console 
output device (pseudo device CO:) with console logging enabled 

Enter [L/R,] num. DLll's <ZL>, num. DH11's, num. DZ1ll's, num. DJ1ll1's for 


Devices that use this prompt are (group 19 devices): Half duplex 
terminal driver, baseline terminal driver 


(continued on next page) 
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Table 5-1 (Cont.) 
SYSGEN Prompt Lines 


Enter num. DL11's <ZL>, num. DHI11's, num. DZ1ll's num. DJ1l1's for: 
Devices that use this prompt are (group 20 devices): Full duplex 
terminal driver 

Enter vector, CSR for: 

Devices that use this prompt are (group 21 devices): DL11 


asynchronous’ line interface (TT:). SYSGEN refers to this device 
aS ZL. 


Enter vector, CSR, highest line number <0 to 15> 
(, answer speed, DM11-BB vector, DM11-BB CSR) for: 


Devices that use this prompt are (group 22 devices): DH11 
terminal interface (TT:). SYSGEN refers to this device as DH. 


Enter vector, CSR, highest line number <0 to 15> for: 


Devices that use this prompt are (group 23 devices): DJ11 
terminal interface (TT:). SYSGEN refers to this device as DJ. 


Enter vector, CSR, highest line number <0 to 7> [, answer speed] for: 


Devices that use this prompt are (group 24 devices): DZ11 
terminal interface (TT:). SYSGEN refers to this device as DZ. 


The following is a detailed description of all the possible peripheral 
questions. 


Enter [L/R,] vector, CSR for: 
1. CR controller 0 [D:230,177160] 


Enter the interrupt vector address (the default value is 230) 
and the CSR address (the default value is 177160) for the 
first CRl1 card reader controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent CR11 controllers do not default the vector and CSR 
assignments; you must enter a value within the acceptable 
range. 


1. CT controller 0 [D:260,177500] 


Enter the interrupt vector address (the default value is 230) 
and the CSR address (the default value is 177160) for the 
first TAl1l cassette controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 
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Subsequent TAll controllers do not default the vector and CSR 
assignments.; you must enter a value within the acceptable 
range. 


DF controller 0 [D:204,177460] 


Enter the interrupt vector address (the default value is 204) 
and the CSR address (the default value is 177260) for the 
first RF1ll controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent RF1l controllers do not default the vector and CSR 
assignments; you must enter a value within the acceptable 
range. 


MS controller O [D:224,172522] 


Enter the interrupt vector address (the default value is 224) 
and the CSR address (the default value is 172522) for the 
first TS11 controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR. 


Subsequent TS11 controllers do not default the vector and CSR 
assignments; you must enter a value within the acceptable 
range. 


PP controller 0 [D:74,177554] 


Enter the interrupt vector address (the default value is 74) 
and the CSR address (the default value is 177554) for the 
first PCll controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent PC1ll controllers do not default the vector and CSR 
assignments; you must enter a value within the acceptable 
range. 


PR controller 0 [D:70,177550] 


Enter the interrupt vector address (the default value is 70) 
and the CSR address (the default value is 177550) for the 
first PC1l1/PR11 controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent PC11/PR11 controllers do not default vector. and 
CSR assignments; you must enter a value within the 
acceptable range. 
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1. UD controller 0 [D:234,171776] 


Enter the interrupt vector address (the default value is 234) 
and the CSR address (the default value is 171776) for the 
UDC11 controller. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


After you specify the interrupt vector address and the CSR 
address. for the UDC11, SYSGEN immediately prompts for UDC11l 
module information using SYSGEN prompt line 17. For clarity, 
this section lists the prompt lines in numeric order, not in 
logical sequence. If you were performing a SYSGEN and 
included a UDC1l1l controller, the questions for UDC11 would 
follow the vector and CSR assignments. 


1. XB controller 0 [D:124,172414] 


Enter the interrupt vector address (the default value is 124) 
and the CSR address (the default value is 172414) for the 
first DA11-B interface. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent DA11-B interfaces do not default the vector and 
CSR assignments; you must enter a value within the 
acceptable range. 


Enter [L/R,] vector, CSR, number of drives, unit number of first drive, 
[O=offset recovery support/NO=no support] for: 


2. DB controller 0 [254,176700,,0,0] 


Enter the interrupt vector address (the default is 254), the 
CSR address (the default is 176700), the number of RP04/05/06 
drives (there is no default for this parameter), the unit. 
number of the first drive (the default for the first physical 
unit number is 0), and whether or not the controller supports 
offset recovery (the default is 0, to support offset 
recovery) for the first RH11 or RH70 controller. 


Offset recovery Support provides a higher degree of data 
integrity in environments where disk packs are frequently 
moved from drive to drive. This support moves the disk head 
on either side of the cylinder centerline in an attempt to 
pick up a stronger signal. Thus, offset recovery support 
allows data to be read in instances where it could not 
otherwise be recovered. 


If you use the default values (enter two commas (,,) followed 
by the number of drives), the acceptable range for the number 
of drives is 1-8. 
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I£ you do not use the default values, the acceptable ranges 
(response) are: 


vector 60-774 (octal) 

CSR 160000-177700 (octal) 
number of drives 1-8 (decimal) 

unit number of first drive 1-7 (decimal) 

offset recovery O or NO 


Subsequent RH11 or RH70 controllers for IB: default only the 
unit number of the first drive (to 0). 


NOTE 


You can only specify offset recovery 
support for the first DB controller. If 
you include support for the first 
controller, you automatically include 
offset recovery support for subsequent 
controllers. Likewise, if you exclude 
Support, you exclude offset recovery 
support for subsequent controllers. 


After you enter the parameters for each RH11 or RH70 
controller included in your system, SYSGEN immediately 
prompts for drive type using SYSGEN prompt line 52. For 
clarity, this section lists the prompt lines in numeric 
order, not in logical sequence. If you were performing a 
SYSGEN and included an RH11 or RH70 controller for DB: 
devices (RP04/05/06), the questions that specify the type of 
drive would follow the DB controller parameter specification. 


DR controller 0 [D:254,176700,,0,0] 


Enter the interrupt vector address (the default is 254), the 
CSR address (the default is 276700), the number of RM02/03 
drives (there is no default for this parameter), the physical 
unit number of the first drive (the default is 0), and 
whether or not the controller supports offset recovery (the 
default is 0, to support offset recovery) for the first RH1l 
or RH70 controller. 


Offset recovery Support provides a higher degree of data 
integrity in environments where disk packs are frequently 
moved from drive to drive. This support moves the disk head 
on either side of the cylinder centerline in an attempt to 
pick up a stronger signal. Thus, offset recovery support 
allows data to be read in instances where it could not 
otherwise be recovered. 


If you use the default values (enter two commas (,,) followed 
by the number of drives), the acceptable range for the number 
of drives is 1-8. 


DETAILS OF SYSGEN PHASE I 


If you do not use the default values, the acceptable ranges 
(response) are: 


vector 60-774 (octal) 

CSR 160000-177700 (octal) 
number of drives 1-8 (decimal) 

unit number of first drive 0-7 (decimal) 

offset recovery O or NO 


Subsequent RH11 or RH70 controllers for DR: default only the 
unit number of the first drive (to 0). 


NOTE 


You can only specify offset recovery 
support for the first DR controller. If 
you include support for the first 
controller, you automatically include 
offset recovery support for subsequent 
controllers. Likewise, if you exclude 
Support, you exclude offset recovery 
support for subsequent controllers. 


After you enter the parameters for each RH11 or RH70 
controller included in your system, SYSGEN immediately 
prompts for drive type using SYSGEN prompt line 56. For 
clarity, this section lists the prompt lines in numeric 
order, not in logical sequence. If you were performing a 
SYSGEN and included an RH11 or RH70 controller for DR: 
devices (RM02/03), the questions that specify the type of 
each drive would follow the DR controller parameter 
specification. 


Enter [L/R,] vector, CSR, number of drives for: 


3. 


DD controller 0O [D:300,176500] 


Enter the interrupt vector address (the default value is 
300), the CSR address (the default value is 176500), and the 
number of DECtape II drives (there is no default for this 
parameter) for the first TU58 controller. 


The acceptable range for the number of DECtape II drives is 
1-2. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent TU58 controllers do not default the vector and CSR 
assignments; you must enter a value, within the acceptable 
range, for the vector and CSR assignments as well as_ the 
number of drives. 


DL controller 0O [D:160,174400] 


Enter the interrupt vector address (the default value is 
160), the CSR address (the default value is 174400), and the 
number of RLO1/02 disk drives (there is no default for this 
parameter) for the first RL11 controller. 


The acceptable range for the number of RLO1/02 disk drives is 
1-4 e 
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If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent RL11 controllers do not default the vector and CSR 
assignments; you must enter a value, within the acceptable 
range, for the vector and CSR assignments as well as_ the 
number of RLO1/02 drives. 


After you specify the vector and CSR assignments and_ the 
number of RLO1/02 drives, SYSGEN immediately prompts for 
drive type using SYSGEN prompt line 53. For clarity, this 
section lists the prompt lines in numeric order, not in 
logical sequence. If you were performing a SYSGEN and 
included an RL11 controller for DL: devices (RL0O1/02), the 
questions that specify the type of drive would follow the DL 
controller parameter specification. 


DP controller 0 [D:254,176714] 


Enter the interrupt vector address (the default value is 
254), the CSR address (the default value is 176714), and the 
number of RP02/03 disk drives (there is no default for this 
parameter) for the first RP11l controller. 


The acceptable range for the number of RP02/03 disk drives is 
1-8(10). 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent RP1l1 controllers do not default the vector and CSR 
assignments; you must enter a value, within the acceptable 
range, for the vector and CSR assignments as well as_ the 
number of RP02/03 drives. 


After you specify the vector and CSR assignments and _ the 
number of RP02/03 drives, SYSGEN immediately prompts for 
drive type using SYSGEN prompt line 55. For clarity, this 
section lists the prompt lines in numeric order, not in 
logical sequence. If you were performing a SYSGEN_ and 
included an RP1l controller for DP: devices (RP02/03), the 
questions that specify the type of drive would follow the DL 
controller parameter specification. 


DX controller 0 [D:264,177170] 


Enter the interrupt vector address (the default value is 
264), the CSR address (the default value is 177170), and the 
number of RXOl floppy disk drives (there is no default for 
this parameter) for the first RX1l controller. 


The acceptable range for the number of RX0O1l floppy disk 
drives is 1-2. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


DETAILS OF SYSGEN PHASE I 


Subsequent RX11 controllers do not default the vector and CSR 
assignments; you must enter a value, within the acceptable 
range, for the vector and CSR assignments as well as_ the 
number of RX0l floppy disk drives. 


DY controller 0 [D:264,177170] 


Enter the interrupt vector address (the default value is 
264), the CSR address (the default value is 177170), and the 
number of RX02 floppy disk drives (there is no default for 
this parameter) for the first RX211 controller. 


The acceptable range for the number of RX02 floppy disk 
drives is 1-2. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR. 


Subsequent RX211 controllers do not default the vector. and 
CSR assignments; you must enter a value, within the 
acceptable range, for the vector and CSR assignments as_ well 
as the number of RX02 floppy disk drives. 


After you specify the vector and CSR assignments and_ the 
number of RX02 drives, SYSGEN immediately prompts for drive 
density using SYSGEN prompt line 58. For clarity, this 
section lists the prompt lines in numeric order, not in 
logical sequence. If you were performing a SYSGEN and 
included an RX211 controller for DY: devices (RX02), the 
questions that specify the density of each RX02 drive would 
follow the DY controller parameter specification. 


MM controller 0 [D:224,172440] 


Enter the interrupt vector address (the default value is 
224), the CSR address (the default value is 172440), and the 
number of TU45, TU16, TE16, or TU77 magtape drives (there is 
no default for this parameter) for the first RH11 or RH70 
controller, TMO2 or TMO3 tape controller. 


The acceptable range for the number of tape drives is 1-8. 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent controllers of this type do not default the vector 
and CSR assignments; you must enter a value, within the 
acceptable range, for the vector and CSR assignments as well 
as the number of tape drives. 


After you specify the vector and CSR assignments and _ the 
number of TU45, TE16, TU16, or TU77 tape drives, SYSGEN 
immediately prompts for the TMO2 or TMO3 number using SYSGEN 
prompt line 51. For clarity, this section lists the prompt 
lines in numeric order, not in logical sequence. If you were 
performing a SYSGEN and included an MM: device (TU45, TU16, 
TE16, or TU77), the questions that specify the TMO02 or TMO3 
number would follow the MM controller parameter 
specification. 
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MT controller 0 [D:224,172522] 


Enter the interrupt vector address (the default value is 
224), the CSR address (the default value is 172522), and the 
number of TSO03, TU10, or TE10O magtape drives (there is no 


default for this parameter) for the first TMll, TMAI1, or 


TMB11 controller. 


The acceptable range for the number of tape drives is 
1-8(10). 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent controllers of this type do not default the vector 
and CSR assignments; you must enter a value, within the 
acceptable range, for the vector and CSR assignments as_ well 
as the number of tape drives. 


Enter [L/R,] vector, CSR, F=full duplex /H=half duplex, 


E=error detec. unit /NO=no, C=char. detec unit /NO=no, 
number of sync characters in leader for: 


XQ controller O [D:,,H,E,C] 


The vector address for the DQ11 synchronous line interface is 
assigned from the floating vector space starting at 300. 
Thus, there is no default vector address for the DQl1. Enter 
a vector address between 300 and 774. Consult Field Service 
if the vector address is unknown. 

The CSR address for the DQl11 synchronous line interface is 
assigned from the floating address space starting at 160010. 
Thus, there is no default CSR assignment for the DQ11. Enter 
a CSR address between 160010 and 177700. Consult Field 
Service if the CSR address is unknown. 


The first DQl1 line defaults to a half duplex line (H), with 
an error detection expander unit (E), and .a character 
detection expander unit (C). Enter F, NO, or NO respectively 
to override these defaults. 


There is no default value for the parameter that specifies 
the required number of sync characters in a sync leader. You 
must enter a value in the range 3-14(10). A typical response 
is 4-6. If the line is to run at high speeds or if the 
expected system load is to be heavy, specify a greater number 
of syne characters. 


Subsequent DQl1 lines do not default any of the parameters; 
you must enter values for the vector and CSR assignments 
(vector range is 300-774, CSR range is 160010-177700 both 
octal), whether the line is half duplex (H) or full duplex 
(F), whether an error detection expander unit is present (E) 
or not (NO), whether a character detection expander unit is 
present (C) or not (NO), and the required number of sync 
characters in a syne leader (range is 3-14 decimal). 


Enter [L/R,] vector, CSR, number of drives, unit number of first drive for: 


5. 
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DS controller 0 [D:204,172040,,0) 


Enter the interrupt vector address (the default value is 
204), the CSR address (the default value is 172040), the 
number of RS03/04 disk drives (there is no default. value _ for 
this parameter), and the unit number of the first RS03/04 
drive (the default value is 0) for the first RH11 or §RH70 
controller. 


The acceptable range for the number of RS03/04 drives is 1-8. 


If you do not use the default values, the acceptable ranges 
are: 


vector 60-774 (octal) 

CSR 160000-177700 (octal) 
number of drives 1-8 (decimal) 

unit number of first drive 0-7 (octal) 


Subsequent RH11 or RH70 controllers default only the unit 
number of the first drive (to 0). 


After you enter the parameters for each RH11 or _ RH70 
controller included in your system, SYSGEN immediately 
prompts for drive type using SYSGEN prompt line 57. For 
Clarity, this section lists the prompt lines in numeric 
order, not in logical sequence. If you were performing a 
SYSGEN and included an RH11 or RH70 controller for DS: 
devices (RS03/04), the questions that specify whether’ each 
drive is an RSO3 or an RSO4 would follow the DS controller 
parameter specification. 


Enter [L/R,] vector, CSR, highest unit number <0 to 7> for: 


6. 


DK controller 0 [D:220,177404] 


Enter the interrupt vector address (the default value is 
220), the CSR address (the default value is 177404), and the 
highest RKO5 unit number (there is no default value for this 
parameter) for the first RK11 controller. 


The acceptable range for the highest RKO5 unit number is 0-7. 
Note that if you want the first RKO5 unit number to be 0, 
enter the number of RKO5 drives minus one as the highest unit 
number. 


If you do not enter the default vector and CSR assignments, 
the acceptable range is 60-774 for the vector and 
160000-177700 for the CSR, both in octal. ' 


NOTE 


Fixed platter RKO5 drives (RKOSF) are 
handled as two units. The first of each 
RKOSF pair must be an even unit number; 
for example, O and 1, 2 and 3. Be Sure 
to take this into account when you 
calculate the highest RKO5 unit number. 


“= 
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Enter vector, CSR, VT11/VS60, number of CRT monitors for: 


7. 


GR controller 0O [D:,172000,,1] 


RSX-11M supports the graphics display subsystem with the 
following restrictions. 


l. One, and only one, VT11l or VS60 in the system 


2. The graphics display driver does not operate on PDP-11/70 
processors in 22-bit mode; memory size must be less than 
or equal to 124K-words. 


3. For systems using the VTll, the display buffer of the 
task driving the VT1l1 must completely reside in the low 
28K-words of system memory 


The vector address for the graphics display subsystem is 
assigned from the floating vector space starting at 300. 
Thus, there is no default vector address for the graphics 
display subsystem. Enter a vector address between 300 and 
774. (Consult Field Service if the vector address is unknown. 


After you specify the vector address, enter the CSR address 
(the default value is 172000), whether the connected terminal 
is a VT1ll or a VS60 (there is no default for this parameter), 
and the number of CRT monitors (the default value is 1). 


If you do not enter the default values for the CSR assignment 
and the number of CRT monitors, the acceptable range is 
160000-177700 for the CSR and 1-2 for the number of CRT 
monitors, all in octal. 


NOTE 


Only the vS60 can drive two CRT monitors 
independently. Thus, if your system 
includes the VTl1l you must specify one, 
the default value, for the number of CRT 
monitors. 


Enter [L/R,] CSR, number of A/D channels for: 


8.. 


AD controller 0 [D:176770] 


The ADO1-D analog-to-digital converter is a non-interrupt 


device. Therefore, you do not enter an interrupt vector 
address. 


Enter the CSR address (the default value is 176770) and_ the 
number of A/D channels (there is no default for this 
parameter) for the first ADO1-D controller. 


The acceptable range for the number of A/D channels is 
1-64(10). If you do not enter the default value for the CSR 
assignment, the acceptable range is 160000-177700 (octal). 


Subsequent ADO1-D controllers do not default the CSR 


assignment; you must enter a value within the acceptable 
range. 
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Enter [L/R,] vector, CSR, number of A/D channels for: 


9. 


AF controller 0 [D:134,172570] 


Enter the interrupt vector address (the default value is 
134), the CSR address (the default value is 172570), and the 
number of A/D channels (there is no default for this 
parameter) for the first AFC1l controller. 


The acceptable range for the number of A/D channels is 
1-1024(10). 


If you do not enter the default values for the vector and CSR 
assignments, the acceptable range is 60-774 for the vector 
and 160000-177700 for the CSR, both in octal. 


Subsequent AFCl1l controllers do not default the vector and 
CSR assignments; you must enter a value, within’ the 
acceptable range, for the vector and CSR assignments as well 
as the number of A/D channels. 


Enter [L/R,] clock vector, CSR, polarity mask, D-D/A channel /NO=no, 


10. 


maximum number of samples/second, DRK=DR11-K/NO=no 
(,DR11-K CSR) for 


AR controller 0 [{D:,170400,,,,,170420] 


The clock vector address for the AR11 controller is assigned 
from the floating vector space starting at 300. It is 
located at an offset of four (4) from the beginning of the 
AR11 vector space. Thus, there is no default clock vector 
address for the AR11. Enter a clock vector address between 
300 and 774. Consult Field Service if the clock vector 
address is unknown. 


The standard CSR address for the AR11 is 170400. Specify the 
address of the first word of the AR11 CSR group (the default 
value is 170400). If you do not enter the default CSR 
address, the acceptable range is 160000-177700. 


The polarity mask word specifies whether an individual 
channel is uni-polar or bi-polar; it corresponds one-to-one 
with the 16 possible channels. A 1-bit designates a 
uni-polar channel and a O-bit designates a bi-polar channel. 
The acceptable range for the polarity mask word is 0-177777 
octal (0 specifies 16 bi-polar channels, 177777 specifies 16 
uni-polar channels). 


The AR11 module includes a D/A converter. However, support 
for the D/A is optional in the driver. If you do not include 
Support (enter NO for parameter 4), the driver will be 
significantly shorter. 


The maximum number of samples must be evenly divisible into 
10,000 and within the acceptable range of 1-2500(10). 


The AR11 does not include the 16-bit digital I/O option that 
is available with the LPS11. However, you can achieve the 
same functionality using the DR11-K. The * DR11-K must be 
jumper selected to use the 16 individual input lines without 
interrupts. If the DR11-K option is present, enter the CSR 
address of the DR11-K (the default value is 170420). If you 
do not enter the default DR11-K CSR address, the acceptable 
range is 160000-177700, octal. 


5-58 
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Subsequent AR11 controllers default only the CSR address of 
the DR11-K option; you must enter values within the 
acceptable ranges. Also, if subsequent AR11 controllers do 
not include the DR11-K option, you must exclude this 
parameter. 


Enter [L/R,] clock vector, CSR, #A/D channels, G=gain ranging option /NO=no, 
polarity mask, bandwith filter channel select delay, 
number of D/A channels, D=digital I/O option /NO=no, 
maximum number of samples/second for: 


ll. LS controller O [D:,170400,,,0,0,0,NO] 


The clock vector address for the LPS11 controller is assigned 
from the floating vector space starting at 300. It is 
located at an offset of four (4) from the beginning of the 
LPS1l1 vector space. Thus, there is no default clock vector 
address for the LPS1ll. Enter a clock vector address between 
300 and 774 octal. Consult Field Service if the clock vector 
address is unknown. 


The standard CSR address for the LPS11 is 170400. Specify 
the address of the first word of the LPS11 CSR group (the 
default value is 170400). If you do not enter the default 
CSR address, the acceptable range is 160000-177700 octal. 


The next parameter is the number of A/D channels; enter a 
value in the range 1-64(10) to specify the number of A/D 
channels on the first LPS11 controller. 


You must then enter whether or not the gain ranging option is 
presént. If the gain ranging option is present, you must 
specify the polarity mask word and the bandwith filter 
channel select delay (if required). 


The polarity mask word specifies whether an individual 
channel is uni-polar or bi-polar; it corresponds one-to-one 
with the 16 possible channels. A 11-bit designates a 
uni-polar channel and a 0-bit designates a bi-polar channel. 
The acceptable range for the polarity mask word is 0-177777 
octal (0 specifies 16 bi-polar channels, 177777 specifies 16 
uni-polar channels). 


With bandwith filtering enabled, the LPS1l1 driver imposes a 
software delay between changing channels on the multiplexer 
and initiating an A/D conversion. This delay can range from 
85 usec to 8.5 msec. Consult the LPS11 documentation to 
determine the proper delay for your application. Note that 
the response must be in 100 usec units (for example, specify 
25 to delay 2.5 msec). The acceptable range is 0-85. Enter 
0 to disable bandwith filtering. 


If your system includes the D/A option, enter the number of 
channels in the range 0-10(10). A response of 0 indicates 
the option is not present. The first two D/A channels 
correspond to the X and Y registers of the display 
controller. Up to eight additional D/A channels may be 
specified if the external D/A option is present. 
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The LPS11 supports a digital I/O and relay module. You must 

specify whether or not the option is present. You then enter 

the maximum number of samples per’ second. The acceptable ss 
range is 1-2500(10). Note that this value must be a multiple : 
of 10,000 (1, 2, 4, 5, 8, 10, 16, 20, 25, 40, 50, 80, 100, 

125, 200, 250, 400, 500, 625, 1000, 1250, 2000, or 2500). 


Enter [L/R,] vector, CSR (, number of UMRs) for » 
12. LA controller O [D:300,170460,0] 


Enter the interrupt vector address (the default value is 
300), the CSR address (the default value is 170460), and the 4 
number of UNIBUS Mapping Registers (UMRs) for the LPA11-K. 


The UMR parameter applies only to PDP-11/70 processors with 
extended memory (22-bit mapping) Support. Enter a value to 
specify the maximum number of UMRs that the LPA11-K driver 
can use to map all currently active LPA11-K I/O transfers. 


See the RSX-11M/M-PLUS I/0 Drivers Reference Manual for 


details. 


NOTE 


The vector address is assigned from 
floating vector. space. Consult Field 
Service if the location is’ unknown. 
Also, the required CSR address is that 
of the first word of the LPA11 CSR 
group. Again, consult Field Service if 
unknown. 


Enter [L/R,] vector, CSR, # drives, O=offset recovery /NO=no offset rec. for: 
13. DM controller 0 [230,177440,,0] 


Enter the interrupt vector address (the default value is 
210), the CSR address (the default value is 177440), the 
number of RK06/07 disk drives (there is no default for this 
parameter), and whether or not the controller is to support 
offset recovery (the default is to include offset recovery 
Support (0)) for the first RK611 controller. 


The acceptable range for the number of RKO6/07 drives is 
1-8(10). 


Offset recovery Support provides a higher degree of data 

integrity in environments where disk packs are frequently 

moved from drive to drive. This support moves the disk head 

on either side of the cylinder centerline in an attempt to 

pick up a stronger signal. Thus, offset recovery support ® 
allows data to be read in instances where it could not 

otherwise be recovered. 


If you do not use the default vector and CSR assignments, the 


acceptable range is 60-774 for the vector and 160000-177700 
for the CSR, both octal. 
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Subsequent RK611 controllers do not default the vector and 
CSR assignments; you must enter a value, within the 
acceptable range, for the vector and CSR assignments as well 
as the number of RKO6/07 drives. 


NOTE 


You can only specify offset recovery 
Support for the first controller. If 
you include support for the first RK6l1l 
controller, you automatically include 
offset recovery Support for subsequent 


controllers. Likewise, if you exclude 
Support, you exclude offset recovery 
support for subsequent RK611 


controllers. 


After you enter the parameters for each RK611 controller 
included in your system, SYSGEN immediately prompts for drive 
type using SYSGEN prompt line 54. For clarity, this section 
lists the prompt lines in numeric. order, not in logical 
sequence. If you were performing a SYSGEN and included an 
RK611 controller for DM: devices (RK06/07), the questions 
that specify whether each drive is an RKO6 or an RKO7_ would 
follow the DM controller parameter specification. 


Enter [L/R,] vector, CSR, F=full duplex /H=half duplex, 


14. 


number of characters in sync leader for: 
XL controller O [D:,,H] 


The vector address for the DL11-E asynchronous line interface 
is assigned from the floating vector space starting at 300. 
Thus, there is no default vector address for the DLI11-E. 
Enter a vector address between 300 and 774. Consult Field 
Service if the vector address is unknown. 


The CSR address for the DL11-E asynchronous line interface is 
assigned from the floating address space starting at 175610. 
Thus, there is no default CSR assignment for the DL11-E. 
Enter a CSR address between 175610 and 177700 octal. Consult 
Field Service if the CSR address is unknown. 


The first DL11-E line defaults to a half duplex line (H). 
Enter F to specify a full duplex line. 


There is no default value for the parameter that specifies 
the required number of syne characters in a sync leader. You 
must enter a value in the range 3-14(10). A typical response 
is 4-6. If the line is to run at high speeds or if the 
expected system load is to be heavy, specify a greater number 
of sync characters. 


Subsequent DL11-E lines do not default any of the parameters; 
you must enter values for the vector and CSR assignments 
(vector range is 300-774, CSR range is 175610-177700), 
whether the line is half duplex (H) or full duplex (F), and 
the required number of sync characters in a sync leader 
(range is 3-14). 


14. 


14. 
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XP controller 0 [D:,174770,H] 


The vector address for the DPll synchronous line interface is 
assigned from the floating vector space starting at 300. 
Thus, there is no default interrupt vector address for the 
DPll. Enter a vector -:address between 300 and 774 octal. 
Consult Field Service if the vector address is unknown. 


The standard CSR assignment for the DP1ll is 174770. If you 
do not enter the default CSR address, enter a value in the 
range 160000-177700 octal. : 


The first DPll line defaults to a half duplex line (H). 
Enter F to specify a full duplex line. 


There is no default value for the parameter that specifies 
the required number of sync characters in a syne leader. You 
must enter a value in the range 3-14(10). A typical response 
is 4-6. If the line is to run at high speeds or if the 
expected system load is to be heavy, specify a greater number 
of sync characters. 


Subsequent DPll lines default only the half duplex parameter 
(H); you must enter values for the vector and CSR 
assignments (vector range is 300-774, CSR range is 
160000-177700 both octal), and the required number of sync 
characters in a syne leader (range is 3-14 decimal). 


XU controller O [D:,,F] 


The vector address for the DU11 synchronous line interface is 
assigned from the floating vector space starting at 300. 
Thus, there is no default interrupt vector address for the 
DU11. Enter a vector address between 300 and 774 octal. 
Consult Field Service if the vector address is unknown. 


The CSR address for the DU11 synchronous line interface is 
asSigned from the floating address space starting at 160010. 
Thus, there is no default CSR assignment for the DU11. Enter 
a CSR address between 160010 and 177700 octal. Consult Field 
Service if the CSR address is unknown. 


The first DU11 line defaults to a full duplex line (F). 
Enter H to specify a half duplex line. 


There is no default value for the parameter that specifies 
the required number of sync characters in a sync leader You 
must enter a value in the range 3-14(10). A typical response 
is 4-6, If the line is to run at high speeds or if the 
expected system load is to be heavy, specify a greater number 
of sync characters. 


Subsequent DU11 lines default only the full duplex parameter 
(F); you must enter values for the vector and CSR 
assignments (vector range is 300-774, CSR range is 
160010-177700 both octal), and the required number of sync 
characters in a sync leader (range is 3-14 decimal). 
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14. XW controller 0 [D:,,H] 


The vector address for the DUP11 synchronous line interface 
is assigned from the floating vector space starting at 300. 
Thus, there is no default interrupt vector address for the 
DUP11. Enter a vector address between 300 and 774 octal. 
Consult Field Service if the vector address is unknown. 


The CSR address for the DUP11 synchronous line interface is 
assigned from the floating address space starting at 160010. 
Thus, there is no default CSR assignment for the DUPI11l. 
Enter a CSR address between 160010 and 177700 octal. Consult 
Field Service if the CSR address is unknown. 


The first DUP11 line defaults to a half duplex line (H). 
Enter F to specify a full duplex line. 


There is no default for the parameter that specifies’ the 
required number of sync characters in a syne leader. You 
must enter a value in the range 3-14(10). A typical response 
is 4-6. If the line is to run at high speeds or if the 
expected system load is to be heavy, specify a greater number 
of sync characters. 


Subsequent DUP11 lines do not default any of the parameters; 
you must enter values for the vector and CSR assignments 
(vector range is 300-774, CSR range is 160010-177700 both 
octal), whether the line is half duplex (H) or full duplex 
(F), and the required number of sync characters in a_=e syne 
leader (range is 3-14 decimal). 


Enter [L/R,] vector, CSR, F=full duplex/H=half duplex /P=primary HDX for: 
15. XM controller 0 


The vector address for the DMCll interprocessor link is 
assigned from the floating vector space starting at 300. 
Thus, there is no default interrupt vector address for _ the 
DMCll. Enter a vector address between 300 and 774 octal. 
Consult Field Service if the vector address is unknown. 


The CSR address for the DMCll interprocessor link is assigned 
from the floating address space starting at 160010. Thus, 
there is no default CSR assignment for the DMCll. Enter a 
CSR address between 160010 and 177700 octal. Consult Field 
Service if the CSR address is unknown. 


Normally, the DMCll is a full duplex serial communications 
link. When the DMCl1l is used on a half duplex line, one end 
of the line must be the primary station and the other’ end 
must be the secondary station. Specify an H to indicate that 
the line is a secondary station or P to indicate that the 
line is a primary station. 
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Enter [L/R,] vector, CSR, printer type 
(, [KMC timeout count <0O=noKMC>, KMC vector, KMC CSR]) for: 


16. LP controller 0 [D:200,177514,LA180,0,300,160130] 


Enter the interrupt vector address (the default value is 

200), the CSR address (the default value is 177514), and the 

printer type (the default type is LA180) for the first LP 
controller. Valid printer types are: LA180; LP11-C; * 
LP11-D; LP11-F; LP11-H; LP11-J; LP1l1-K; LP11-R; LP11-S; 

LP11-V; LP11-w; LP11-Y; LP11-Z; LS11; LVll. For printer 

widths and speed, consult Field Service or the PDP-1l 
Peripherals Handbook. 


If your system includes KMC line printer support, you must 
enter the KMC timeout count (the default of 0 excludes KMC 
support), the KMC interrupt vector address (the default value 
is 300), and the KMC CSR address (the default value is 
160130). 


The timeout count specifies the interval in which the KMC 

polls the line printer between print lines. This value is a 
measured in units of 50 micro seconds. For example, if you uns 
enter 1, the KMC polls the line printer every 100 micro 

seconds (as each print buffer empties). The acceptable range 

is 0-100 decimal. For slower printers, poll less frequently 

(enter a higher number) ; the polling interval 
increases/decreases UNIBUS latency. 


The acceptable range for the KMC interrupt vector address is 
60-774 and for the KMC CSR address the range is 
160000-177700, both in octal. 


NOTE 
If you select KMC Support, all printers 


must use the KMC; those that do not 
will not operate. 


You can connect a maximum of eight line printers to the 
system. 


Enter number of modules, module number of first for: 


17. UD controller O xxxx module 


NOTE 


If you specified a UDC1l1l controller, 
this SYSGEN prompt line and the 
questions that follow appear immediately 
after you enter the vector and CSR 
assignments for the UDCll. 


The UDCl1 supports up to 252 modules, which can be classified 
into seven types: 


e Analog input 
e Analog output 
e Bi-stable output 


17. 
17. 
17. 
17. 
17. 
17. 


17. 
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Digital interrupt 
Digital sense 

I/O counter 
Single-shot output 


Modules of the same type must occupy consecutive locations 
within the UDCll. Thus, if there are seven analog input 
modules and the first module starts at slot 0, then the last 
analog input module must be at slot 6. Module types cannot 
overlap, but unassigned slots are permitted. 


SYSGEN asks the following questions to establish UDC11l module 
boundaries. You must enter the number of each module 
contained in the UDCll and identify the slot for that module 
to begin. The permissible range for each entry is 0-252(10). 
Note, however, that SYSGEN decrements the range value for the 
number of each module by the total number of previously 
specified UDCll modules. For example, if you specify 50 
analog input modules, you are limited to 152 of the other 
modules (maximum 252 UDC1l1l modules). Both responses are _ in 
octal. 


UD controller 0 ADUO] analog input module 
UD controller O analog output module 

UD controller 0 bi-stable output module 
UD controller 0 digital interrupt module 
UD controller 0 digital sense module 

UD controller 0 I/O counter module 


UD controller 0 single-shot output module 


Enter [L/R,] terminal number to redirect to (TTn:) for: 


18. 


Enter [L/R,] num. DL1ll's <ZL>, num. DH11's, num. DZ1ll's, num. DJ1l's for: 


19. 


CO controller O [D:0] 


This poorly phrased question requests a terminal number. The 
console output driver redirects the pseudo device CO: to the 
terminal you specify. | 


The default is 0 (TTO:). 


If you do not use the default value, the acceptable range is 
0-77 octal. 


The terminal driver [D:1,0,0,0] 


This question appears only if you selected either one of the 
half duplex drivers including the baseline driver. (The full 
duplex terminal driver is always loadable and appears in 
question 20.) 


For RSX-11M systems, you muSt generate at least one DL1l 
asynchronous terminal interface into the system. RSX-11S 
does not require a DLI1l. 


All responses are in decimal. 
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Enter the number of each type of terminal interface included 
in your system. The default response includes one DL11 
asynchronous terminal interface. If you do not use the 
default response, the acceptable range is 1-8 for the DL11l 
and 0-16 for the DH11, DZ1l, and DJ11 terminal interfaces. 


Enter num. DL1l1's <ZL>, num. DH11l's, num. DZ1ll1l's, num. ODJll's for: 


20. 


The terminal driver [D:1,0,0,0] 


This question appears only if you selected the full duplex 
terminal driver. Note that the optional Loadable/Resident 
parameter does not appear since the full duplex driver is 
always loadable. 


For RSX-11M system, you must generate at least one DLIil 
asynchronous terminal interface into the system. RSX-11S 
does not require a DLI11. 


All responses are in decimal. 


Enter the number of each type of terminal interface included 
in your system. The default response includes one DLI11 
asynchronous terminal interface. If you do not use the 
default response, the acceptable range is 1-8 for the DLI11l 
and 0-16 for the DH11, DZ1ll, and DJ11 terminal interfaces. 


Enter vector, CSR for: 


21. 


ZL controller 0 [D:60,177560] 


This question always appears; you must include at least one 
DL11 line interface in an RSX-11M system. 


The standard interrupt vector address for the first DL11 line 
is 60. I£ you do not use the default vector assignment, the 
acceptable range is 60-774 octal. 


The standard CSR address for the first DL11 line is 177560. 
If you do not use the default CSR assignment, the acceptable 
range is 160000-177700 octal. 


If you specified more than one DL1l, you must enter’ the 
vector and CSR assignment for each additional line. 


Interrupt vector addresses for additional DL1l1 lines are 
assigned from the floating vector space starting at 300. 
There is no default vector address for any additional DL1l 
lines. You must enter a value within the range 300-774 
octal. Consult Field Service if the interrupt vector address 
of additional lines is unknown. 


CSR addresses for additional DL11 lines are assigned from 
floating address space starting at 176000. There is no 
default CSR address for any additional DL11 lines. You must 
enter a value within the range 176000-176770 octal. Consult 
Field Service if the CSR address of additional lines is 
unknown. 
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Enter vector, CSR, highest line number <0 to 15> 


22. 


(, answer speed, DM11-BB vector, DM11-BB CSR) for: 
DH controller 0O [D:,,,300,0,0] 


This question appears only if you specified a DH11 
asynchronous line interface. Note that the Loadable/Resident 
parameter does not appear. 


The interrupt vector address for the DH1ll1 is assigned from 
floating vector space starting at location 300. Thus, there 
is no default vector assignment for the DHll. Enter a vector 
address between 300 and 774 octal. Consult Field Service if 
the interrupt vector address is unknown. 


The CSR address for the DH11 is assigned from floating 
address space starting at 160010. Thus there is no default 
CSR assignment for the DHl1l. Enter a CSR address’ between 
160010 and 177700 octal. Consult Field Service if the CSR 
address is unknown. 


The DH11 can service up to 16 remote and local lines. Remote 
lines occupy consecutive line locations. Line assignment is 
by groups of four. Local lines also occupy consecutive line 
locations and their assignment follows the assignment of any 
remote lines specified. Enter the total number of lines 
desired by specifying the highest line number in the range 
0-15 decimal (0 indicates one line, 15 indicates 16 lines). 


If your DH11 includes DM11-BB modem Support, you must’ enter 
the baud rate at which all DH11 remote lines are answered. 
The default answer speed is 300. If you do not use the 
default response, the acceptable answer speed baud rates are 
50, 75, 110, 134.5, 150, 200, 300, 600, 1200, 2400, 4800, or 
9600. If included, you must also specify the DM11-BB vector 
and CSR assignments. The default response of 0 excludes 
DM11-BB modem support. To include DM11-BB modem support, you 
must enter a value for the vector and CSR assignments. 


The DM11-BB interrupt vector address is assigned from 
floating vector space starting at 300. Thus, you must enter 
a value between 300 and 774 octal to include DM11-BB modem 
support. Consult Field Service if the interrupt vector 
address is unknown. 


The standard CSR address for the DM11-BB is 170500. If you 
include DM11-BB support, enter 170500 or a value within the 
range 160000-177700 octal for the CSR assignment. 


SYSGEN repeats this question for each DH11l specified. 


Enter vector, CSR, highest line number <0 to 15> for: 


23% 


DJ controller 0 


This question appears only if you specified a DJ11 
asynchronous line multiplexer. Note that the 
Loadable/Resident parameter does not appear. This is because 
the DJ11 uses the same driver as the DL11l and the DHll. 


5-67 


DETAILS OF SYSGEN PHASE I 


The interrupt vector address for the DJ1l is assigned from 
floating vector space starting at 300. Thus, there is no 
default vector assignment for the DJll. Enter a vector 
address between 300 and 774 octal. Consult Field Service if 
the vector address is unknown. 


The CSR address for the DJ1l is assigned from floating 
address space starting at 160010. Thus , there is no default 
CSR assignment for the DJ1l. Enter a CSR address’ between 
160010 and 177700 octal. Consult Field Service if the CSR 
address is unknown. 


Each DJ1l can service up to 16 asynchronous’ serial lines. 
Enter the total number of lines by specifying the highest 
line number in the range 0 to 15 decimal (0 indicates’. one 
line, 15 indicates 16 lines). 


SYSGEN repeats this question for each DJ1l specified. 


Enter vector, CSR, highest line number <0 to 7> [, answer speed] for: 


24. 


DZ controller O [D:,,,0] 


This question appears only if you specified a DZ11 
asynchronous line multiplexer. Note that the 
Loadable/Resident parameter does not appear. 


The interrupt vector address for the DZ11 is assigned from 
floating vector space starting at 300. Thus, there is no 
default vector assignment for the DZll. Enter a vector 
address between 300 and 774 octal. Consult Field Service if 
the vector address is unknown. 


The CSR address for the DZ1il is assigned from floating 
address space starting at 160010. Thus, there is no default 
CSR assignment for the DZ11. Enter a CSR address’ between 
160010 and 177700 octal. Consult Field Service if the CSR 
address is unknown. 


Each DZ1l can service up to 8 asynchronous lines. Enter’ the 
total number of lines by specifying the highest line number 
in the range 0 to 7 decimal (0 indicates one line, 7 
indicates 8 lines). 


The DZ11 can maintain a full duplex connection through a Bell 
103A type modem. However, modem Support requires additional 
code in the terminal database as well as in the driver and 
thus increases system overhead; select modem support only if 
needed. If you wish to include modem support, specify the 
baud rate at which all DZ11l remote lines are to be answered. 
Acceptable answer speed baud rates are 50, 75, 110, 134.5, 
150, 200, 300, 600, 1200, 2400, 4800, or 9600. Note that the 
default for this parameter (0) excludes modem support. 


SYSGEN repeats this question for each DZll specified. 
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The following questions provide additional device information and 
immediately follow the respective SYSGEN prompt line for controller 


Z information. 
= s 
*51. MM controller O unit 0. formatter [D R:0-7 D:0] 
This question immediately follows parameter specification for 
. each MM controller (SYSGEN prompt line 3). You must identify 
the number (the unit plug) for the TM02/03 formatter (tape 
controller) on the RH11 or RH70. The default is 0. If you 
do not use the default response, the acceptable range is 0-7. 
SYSGEN repeats this question for each device unit specified 
: for each controller. 
*52. Contr 0 unit 0. is an RP04,05/RP06 [D:RP06] 
This question immediately follows parameter specification for 
each DB controller (SYSGEN prompt line 2). You must specify 
the type of drive. Enter RPO6 (the default response), RP04 
or RPOS. 
ES SYSGEN repeats this question for each device unit specified 
‘Nw’ for each controller. 


*53. Contr 0 unit 0. is an RLO1/RLO2 [D:RLO1] 


This question immediately follows parameter specification for 
each DL controller (SYSGEN prompt line 3). You must specify 
the type of drive. Enter either RLO1 (the default response) 
or RLO2. 


SYSGEN repeats this question for each device unit specified 
wa for each controller. 


*54. Contr 0 unit 0. is an RKO6/RKO7 [D:RK06] 


This question immediately follows parameter specification for 
each DM controller (SYSGEN prompt line 13). You must specify 
the type of drive. Enter either RKO6 (the default response) 
or RKO7. 


SYSGEN repeats this question for each device unit specified 
for each controller. 


*55. Contr 0 unit 0. is an RPO02/RP0O3 [D:RP03] 


This question immediately follows parameter specification for 
each DP controller (SYSGEN prompt line 3). You must specify 
the type of drive. Enter either RPO2 or RPO3 (the default 
response). 


es SYSGEN repeats this question for each device unit specified 
for each controller. 


*56. Contr 0 unit 0. is an RM0O2/RMO3 [D:RMO3] 


ies This question immediately follows parameter specification for 
each DR controller (SYSGEN prompt line 2). You must specify 
the type of drive. Enter either RMO2 or RMO3 (the default 
response). 


SYSGEN repeats this question for each device unit specified 
j for each controller. 
Nee” 


*57 . 


*58. 
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Contr 0 unit 0. is an RSO3/RS04 [D:RS04] 


This question immediately follows parameter specification for 
each DS controller (SYSGEN prompt line 5). You must specify 
the type of drive. Enter either RSO3 or RSO4 (the default 
response). 


SYSGEN repeats this question for each device unit specified 
for each controller. 


Contr 0 unit 0. is SINGLE/DOUBLE density 


This question immediately follows parameter specification for 
each DY controller (SYSGEN prompt line 3). You must specify 
whether each RX02 drive is initially at single density or at 
double density. Enter either SINGLE or DOUBLE. 


SYSGEN repeats this question for each device unit specified 
for each controller. 


If your system includes ICS/ICR process I/O subsystems or DSS/DRS 


modules, 


SYSGEN asks the following questions. Note that UDC11 support 


precludes ICS/ICR support; ICS/ICR and UDCl1 are mutually exclusive. 


1 


#2 


*3. 


*4, 


56 


*6. 


Expanded comments for ICS/ICR questions 


Expanded comments provide explanatory text that helps you 
answer the ICS/ICR questions. 


Do you want task activation from unsolicited interrupts 


This option permits the ICS/ICR driver to initiate a task 
when the driver receives unsolicited input. The option 
provides support for tasks to link to interrupts and obtain 
activation data upon initiation. 


IC controller 0 vector address 


The standard vector address for the ICS/ICR subsystem is 234. 
Enter a value within the range 234-774. Subsequent IC 
controllers obtain vector assignments from floating vector 
Space starting at 300. Consult Field Service if the vector 
addresses are unknown. 


CSR address 


The standard CSR address for the ICS/ICR subsystem is 171776. 
Enter a value within the range 160000-177700. CSR addresses 
for subsequent IC controllers are assigned starting at 171766 
and proceed downward in eight byte intervals (for example, 
171766, 171756, and 171746). 


Is it an ICR-1l 


Specify whether the subsystem is an ICR=-1l or an IcCS-1l. 
SYSGEN repeats this query for each IC controller specified. 


Number of A/D converter modules in this ICS/ICR 


The ICS/ICR subsystem supports up to 16 analog to digital 
converter modules, each with 8 channels. Enter a value in 
the range 0-16. If you enter a non-zero value, SYSGEN asks 
question 7. SYSGEN repeats this question and, if applicable, 
question 7, for each IC controller specified. 


*7. 


*8. 


The ICS/I 
e D 
e s 
e B 
e D 
e D 
e iI 


SYSGEN pr 
questions 
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A/D converter module number 

Enter the module number in the range 0-15. 
Number of expansion multiplexers 

Enter a value in the range 0-7. 

CR subsystem consists of six distinct modules: 
/A converter 

ingle-shot output 

i-stable output 

igital sense 

igital interrupt 

/O counter 


ompts for the number of each module in your system (in 
12 through 17) and then asks for the module number of each 


(in question 9). 


*12. 
*13. 
*14, 
a he I 
*16. 
as iy a 
#9. 


*10. 


*1lle 


Number of D/A converter modules in this ICS/ICR 

Number of single-shot output modules in this ICS/ICR 

Number of bi-stable output modules in this ICS/ICR 

Number of digital sense modules in this ICS/ICR 

Number of digital interrupt modules in this ICS/ICR 

Number of I/O counter modules in this ICS/ICR 

(module name) module number 
This question appears for each module you include (specify a 
non-zero number of modules). Enter a value in the range 
0-15. 

Restore module status on power and error recovery 
This question appears only if the system includes a bi-stable 
output, D/A converter, or I/0 counter module (non-zero 
response to questions 14, 12, or 17 respectively). 
If you select this option, the ICS/ICR driver restores’ the 
state of all bi-stable digital outputs, analog outputs, and 
I/O prescalar values on power recovery and recovery from 
sustained serial transmission errors. 


How many line errors are acceptable per second 


This question appears only if you include the restore module 
Status option (respond Yes to question 10). 


When serial line errors exceed the limit you specify in 
response to this question, the IC driver places the affected 
subsystem offline (when the line errors cease, the driver 
automatically places the subsystem online). Enter a value in 
the range 0-5000. 


*18. 


*19% 
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Expanded comments for DSS/DRS questions 


Expanded comments provide explanatory text that helps you 
answer the DSS/DRS questions. . 


Number of DRS-11 modules 
Enter the number of DRS-11l digital output modules in the 
range 0-16. If you enter 0, SYSGEN omits questions 20, 21, 
and 22. 
Restore module statusS on power and error recovery 
If you select this option, the DRS driver restores the state 
of all 48 buffered digital output modules on power recovery 
and recovery from sustained transmission errors. 
DRS-11 CSR address 
Enter a value for the CSR address in the range 160000-177700. 
DRS-11 vector address 
Enter a value for the vector address in the range 300-774. 
Number of DSS-11 digital input modules 
Enter the number of DSS-11 digital input modules. Note that 
the total number of DRS-11 and DSS-11 modules cannot exceed 
16. Thus, the acceptable range for this response is 0 to. 16 
minus the number of DRS-11 modules specified in question 19. 
If you enter 0, SYSGEN omits questions 24, 25, and 26. 
DSS-11 CSR address 
Enter a value for the CSR address in the range 160000-177700. 
DSS-11 vector address 
Enter a value for the vector address in the range 300-774. 
Task activation from unsolicited interrupts 
This option permits the DSS/DRS driver to initiate a task 
when the driver receives unsolicited input. The option 


provides support for tasks to link to interrupts and obtain 
activation data upon initiation. 


If your system includes IP11/IP300 support, SYSGEN asks the following 
questions. Consult the IP11/IP300 documentation for details on the 
IP11/IP300 I/O subsystem. 


1s 


*2. 


Extended comments for IP11/IP300 


Expanded comments provide explanatory text that helps you 
answer the IP11/IP300 questions. 


Treat all controllers as one unit 


If you respond Yes, SYSGEN generates one SCB and one UCB to 
cover all IP11 controllers. This creates the appearance of a 
Single, large IP1l1l controller with all of the I/0 modules 
connected to it. This option results in a loss of system 
efficiency and also decreases the total number of A/D 
converters to sixteen. 


ae 2 


*4, 
#55 


*6. 
*7. 
*8. 
*9.4 


*10. 
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If you respond No, SYSGEN generates one SCB and one UCB. for 
each IPll controllers. Each controller must then be 
referenced with a different LUN. If you enter No, each 
controller can support sixteen A/D converters, but’ the 
programmer must know which controller a particular I/O module 
is on as well as the module index. 


For example, consider a PDP-1l that has two IP11 controllers. 
Controller No. 0 has one M6011 digital output module (16 
points) and eight A014 A/D converter modules. Controller No. 
l has two M6011 modules (32 points), one M5010 digital input 
Module (32 points), and three A014 modules. If all 
controllers are treated as one unit (Y to the above 
question), the driver will cause the system to respond as if 
there were only one controller with 48 digital output points 
(M6011), 32 digital input points (M5010), and eleven A/D 
converter modules (A014). 


Any latching digital output modules 


Because the IP11/IP300 device driver determines the system 
configuration at bootstrap or power-up time, it is not 
necessary to specify how many of each type of module are 
present. You are asked whether you have (or will ever have) 
each module type so that the code to support unused modules 
will not be assembled. 


Any single-shot output modules 

Direct output via QIO 

This option allows a task to output to digital or single-shot 
output modules without overmapping the I/O page. The option 
simplifies task code, but increases overhead. 

Note that the direct output via QIO support is not required 
in order for FORTRAN support to work. However, if present, 
it will not interfere with FORTRAN support. 

The question appears only if you include a latching digital 
output module or a single-shot output module (Yes response to 
question 3 or 4). 

Any non-interrupting digital sense modules 

Any interrupting digital sense modules 

Any change-of-state modules 

Any counter modules 

Direct input via QIO 

This option allows a task to perform digital input with a QIO 
directive rather than by mapping over the I/O page. The 
option simplifies task code, but increases overhead. 

Note that direct input via QIO is not required for FORTRAN 
support to work. However, if present, it will not interfere 


with FORTRAN support. 


This question appears only if you responded Yes to one or 
more of questions 6, 7, 8, or 9. 


¥1l,. 
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Unsolicited interrupt support 


The M5011, M5012, and M5013 interrupting modules can _ produce 
unsolicited interrupts when certain input bits change state. 
If you select this option, the interrupts can be monitored by 
a task. 


This question appears only if you responded Yes to question 7 
or 8. 


Event flag linkage to interrupts 


A task can monitor digital interrupts by linking a contiguous 
group of event flags to interrupting bits. If you select 
this option, the driver sets the corresponding event flag 
whenever its associated bit causes an interrupt. 


Any D/A converters 

Any A014 A/D converters 

Any A020 A/D converters 

How many output bytes should be saved on powerfail 


The answer to this query reserves table space in the 
IP11/IP300 driver. If the answer to the query is n, 4¥*n 
bytes are reserved. This space is part of the Executive, so 
available pool space is correspondingly decreased. 


At powerfail time, if there is not enough space in the’ table 
to save all outputs, the excess outputs will be lost and will 
not be restored. 


This question appears only if the system includes one or more 
output modules and you included Executive support for power 
fail recovery. Output modules are the M6010, M6012, and 
M6013 Latching Digital Output modules; the M6011 Single-Shot 
Output module; and the A630 D/A Converter module. 


The acceptable range is 0-3048(10). 
Enter 0 (or carriage return) to disable output restoration. 
IPl1 vector 


Enter the interrupt vector address for the first IPl1l 
controller. The standard vector address, and the default 
value, is 234. If you do not use the default assignment, the 
acceptable range is 60-774. Subsequent IP11 controllers are 
assigned vector addresses from floating vector space and 
there is no default. Enter a value within the acceptable 


range. Consult Field Service if the IPl1l vector address is 
unknown. 


Base address 


Note that this question requests the IPll base address and 
not the CSR address. The base address is the CSR address 
minus 377 octal. 


For the first IP11 controller, the default base address is 


171000. For the second IP11 controller, the default base 
address is 171400. 
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The acceptable range for the IPil base address is 
160000-177400. 


The third and subsequent IP11l controllers are assigned base 
addresses from floating address space and do not have default 
responses. Enter a value within the acceptable range. 


Consult Field Service if the IP1l1 base address is unknown. 


5.7 DETAILS OF SYSGEN PROCESSING 


During a system generation, SYSGEN issues command lines and displays 
comment lines. This section uses a console listing from an actual 
system generation to detail and describe the command lines as well as 
interpret the more obscure comment lines. 


The console listing appears below. It is followed by notes which are 
keyed to the listing. 
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RSX-1L1M V3.2 BL26 28K 
SRED DLt=Syt 
FRED DLS het 1 
SMOU DLS RSXM26 rN 
SOD 2 LL» 2ISTARTUF ae 
ok PLEASE ENTER TIME AND DATE CHREMN I-MMM-YY) ES: 72 


2@ EQS 
SINS $800 
SROO Chills S44 2) 


RSX-1LIM V3.2 BL26 HAs MAPRET 
SRED DL 3 SX? 
PRED TW thet 
“MOU TLS RSXM26 
OTL ICL ys 2ASTARTUF 
2K PLEASE ENTER TIME ANT DATE CHREMN D0I-MMM-YY) CS3 12200 23~-MAY~79 
* TIM 22200 23-MAY-79 
SK ENTER LONE WEOTH OF THIS TERMINAL ft tase. as 
SET /BRUFe TEE 32, 
SACS SYI/ELKS eS 2 


NOTE. ~ The Kaseline INirect must be rerlaced tu BRIGINI with 
Ba eriarity of 10. for SYSGEN, 


ie REM «2+ AT. 
SINS $OTGINZERT 10. mar. 


2 EOE 

REM 62+ AT. 

SINS $eIGIND/PRI&LO. 

TNS -- WARNING « FRIVILEGED TASK OVERMARS 170 PAGE © 
SINS $EIGININMAC/ING= 50000 

INS ~~ FARTITION FARLAK NOT IN SYSTEM, DEFAUL TING TO GEN 
ASN DL GeSyt 

*eSYSGEN 


“a> “> “C> “E> “E> “a> “E> 


RSX-1M Version 3.2 BL26 System Generation 3-62.20 done on 23-MAY<-79 at T2t013 


Coryriaivt C0) 1979 Yhisitel Eaudement Coreoratiornsy Maynard Maas. 
RLOL distribution kit 


Ld. Inhibit MOCK command Lines (Ture <ESC> for exelanationd? CY/NIT8 

2. Have vou made a cory of the distribution Bit? EYZNALY 

x Use gaved or canned answer file for dineut reseonseas? EY/NIt 

10. Save resgreonses Ci-«@e? create SYSSAVEN.UATI? CYZNI7Y 

11. UTC for SYSSAVEN files if mot C200r2007 ESI 

12. UEC for SYSGEN command files if mot [2002007 Tsu? 

13. Clean use files from erevious GENS? CY/NI3 

14. Yevicey when reacdysy for Executive saurees Coichiit> Sas Thode y 


ORK KKKKKNK OG Oe GS ae 
ing 


SMOU THOS MARSEC 


QLO? HAS S315. BLOCKS FREE y 6925. BLOCKS USED OUT OF 10240, 
LARGEST CONTIGUOUS SPACID = 30. BLOCKS 


2 
- 


/UTIe Edy Lod 


Target comfisuratior 


Soar ee cae ES 


~*~ 
¢ 


1/349 LSte11) CS ReSe 443 11770 

POLY ANTS 

co Sewoece tlocke) CO Rese. 1920.72 S12 

Mageep Y/N Y . 
4. Ams Kesgeries lahoratory deviees? CY“NIt 


ae 
ee 
” 


a 


. 


ae ee ee ee ee ee ee ee ee ee ee ee eee ee eT ee ee eee 


8. 
10. 
li. 
Le. 
13. 
14. 


Lio 
ued + 


14. 
16. 
16. 
16+ 
16. 
14. 
lds 
és 
LG 
16, 
Gs 


1. 
ae 
4, 
we 


be 


EOS 
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Floating roint rrocessor CFP 11) rresent? CY/NIZY 

If usimes KWLL-F as sustem clock? rumber of intres./sece [0 RtO.-1000.73 
Lime freanerciucsy t An 460 Hz Re $O Me Eos "A" CS7a3 

KWiie¥ Watendos timer gureroarth? EY/NIY 

Memory rarity surerort? CY/NIALTY 

Cache memory? CY/NU13Y 

Highest intberruret veoetor CIF O will be comeuted) [0 RtO-7741% 

For device configuration? "x" Frints device table, *." Terminates ineauiry 
Enter devices and ruumber of cantrollers for devices which reauire drivers 
Nevices [Sit Ik 

Nevices C[S27 TK 

Nevices (S1t 0S 

Nevices Sct IM 

Nevieceas (Sr mx 

Leviees LS? TT 

Yeviees CSI3 MM 

Yeviees CSit oT 

Nevieas ESI Tl 

Nevices | ? LF 
Neviees ESI 


Frocessort Li77o0 Memory SisgetSleksyMarred SyustemthSx-L1iM 


Host configuration 


Are vou running SYSGEN standalone Con the baseline system)? CY/NILY 
Is 8 line erinter available? LY/NA3 

Yie@es the listing/mar device have at least 120 columns? CY/NISY 
Assembly Listings device Cdeut>) EOS "NLt "a CSTs 

Mae device for Executive amd device drivers Cdedut>) C03 Syta (S43 


KX De vou want tot aCKo-continue KR-rereat section E-exit Ferause [S13 


Exeaubive Ortiorns 


Answer YCES) aif the following surrort is desired 


Wild DBMS-11 be used? TY/NIE 

FILES-11 ACE ? LY/NALY 

RMS record locking ane erlacement corbrol? CY/NALY 
Non-resident tasks (task loaderd? CY/NATY 

Loadashble task loader? TY/NITY 

Memory manasemernt CFLAGS) directives? RY/NIALY 
Send/Receive by reference directives? CY/NITY 

Get marrins carntext directive? CY/NITY 

Address checking gurrort will be ine lauded 

I/O rundown gureeort willl be ine luded 

Multi-user eroteetion? TY/SNIUTY 

ANS Masthara ACK? CTY/NUTY 

One Line formatting CFMT) or oneline user=mode diasnhnostics? CY/NITY 
Loadable device drivers? CY/NIUSY 

Showle the default for all aerlicable drivers he loadable? CY/NAVCY 
AST surrort wild te inedluded 

Cancel selective MARKTIMES sumrort will be ine kuded 
Task termination and device mot ready messages CTRTNO? CY/NIUCY 
Fower fail recover? [Y/N Y = 
Installs reauesty and remove om @xitP EY/NIUTY 

Larse C20K) Executive? EY/NA7Y 

Logical device assishmment? CY/NILY 

Logdsirns of device errors and timeouts? CY/NIUTY 

of undefined ainberruets? CY/NULY 

ofr meamary Fearity errors? CY/NITY 

Yo vow adnmbenad to amedude @& ugerewritten driver? CY/NA 
Nigh writeecheck? TY/NAITY 

Execubkive Uehustsina Tool CXuto? LY/ZNITY 

Rotating eattern in data Lights? CY/ZNITY 

Ineuestried metwork ar THECmet? Y/N AS 

Queue manager and aueued erink seooler? LCY/NITY 

Grouse stlobal everct Class? IY/NATY 


sce ote Ghee Se SE a cee Eee Ste So Se Ee Se SE ee EEE EE EE RKO RE KEKR OO UROL KE KRREMMESEEBEEEZ 
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0+ 
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For directives? "kK" Prints tables "." Terminates inauiryys *%" Gets all 
Enter code for directives [S73 Z. 

Number of ere-allocated Q10 rackets CO Rt0O.-15. 85.0% 

Size of data transfer veetor im words CO RtS.-33. 0133.78 

Round-robhin gehecduling interval in ticks Cl RtO.-1000. D89.12 0 

Executive level disk swarrine interval CO R1O.-5000. [230.7% 

Swarring eriority CO Rti.-20. Ut5.7% 

Size af dunamie gtorade resion (FOOL) in words CO RI256.-16384. Df1024.]! 
Seconds between erinber mot reacdy messases Cl R1O.-255. 0630.7! 255 
Sustem crash resister and stack dume device CSR CO R10-177700 031775641! 
Cheekrodrrt dirs? Av Yas KR- With system ckrent. file CS13 &B 
System cntrled crartitionst A Yes 9 Re With auto comeaction (SHF) CSI B 
Qigings aria dis i 3 A- FANTIC B- Crash (CLA) CS13 &B 
Quteut notification device CSR CO R£160000-177700 Dt17756413 

Memory dume device Cddutd ES RI3-471t TKO 

CSR address of dume device CO R$160000-177700 lt17740413 177400 


inal driver orbkiorns 
Terninal dviver desired (A/B/C/Ily * erints table) (Sat 4 
Answer YCES) aif the following sgurerort is desired 


Fass form feeds directly to terminal? CY/NILY 
Automatic carriage rebturn/line feed? CY/NISY 
Task checkrointable during terminal ineut? CY/NILY y 
Unsolicited imeut cheracter AST? CY/NULY ne 
Write with CTRL/O cancellation? CY/NIU¢ 

Breakthrough write sguerort will be ineluded 

CTRLZK gurreoart will be ine luce 

scare geauence hancdlins? CY/N12 

Geb miltirle characteristics? LY/NILY 

Set multiele charsctberisties? LY/NILY 

Get terminal criver oetions? LY/NILY 

Hold sereen mode? LY/NILY 

Transearent read/write surrort will be included 

Setteble case conversion for ineut? CY/NILY 

Reacd after eromet? EY/N1 

Read with mo echo surrort will be ineluded —, 
Read with srecial terminator surrort will be included : 
CRT ruhout susrork? EY/NILY 

Terminal-host synchronization? CY/NAtTY 

User terminal ainmeut buffering? EY/NTLY 

Variable length terminal ineut buffering? CY/NI1t 

LASOF sueeoarh? EY/NI 


k To vou want tok <CKe-conbinue Re-rereat section E-exit Fe-rause CST 

Thrdiie drist eee 

of Exeoutive ortbion seneration at 12f12t49 orn 23-MAY<-79 (a, 
ehered comisuration 

Faraneterdsg 8arrearing in ¢euare brackets "Tee ed?) can looms he 

seecifPied for the firet cantrviler of 3 rarticulaer cevice,. 

Farameters arrearing ain earentheges "“C.4..)" only meed be srecified 

if tne indieated ortion is eresent on the tarset sustem, 

Thie GePeawlt for losdahle drivers has heen set to xXTRUEX, 


To override thig setbLing eanter K Cregident) a6 the first earameter 
for Lite first cantroaliler at the Sreaci fied HEVviCes € 


and Laboratory deviceatl None sreecifiead 
rE PpOCeEgar communication devices? None seecified 


record cevieeed Lr e 


bn To oa 


RA aN ea ai ee 56 Tes es eos ee 36 HE ee ee en EO REM G EGO ORES CSKN ESS wexweeeNNO sap cab ee se> es 36 We > o> 
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Enter EL/Re vectors CSRy erinter ture 
Ce IKMC timeout count <Oenm0 KMES» KMO veetorsy KMC CSRI) for 


16. LP controller O LM 2009177514 91.A18070230091601307 CSA$ 21 773N3\510°LPL1-C 


Visks? Dy TINy Dhy OM» DS» fit, [xX 


Enter CL/Red vectors CSR: mumber of drivesr unit number of first drives 
COsaffset recovery surrort/NO=no0 surrort fort 


QB controller 0 EY 2547176700900) CSI v4 


ae 
vee Comtr O unit Of. is am RFO4,05/RPO6 COI RFOSI CSI! 
S2-< Contr O unit 1. is am RFO4sOS/RFO4 EOL RFOSI CSIt 
Yee Contr O unit 2. is an REFO4,OS/RFO4 Cht RFOST CS1t RFOS 
S20 Contr O unit 3. is an RPO4,O5/KRFO6 Cll RFO6I CS: RPO4 


Enter CL/Red vectors CSRy highest unit mumber <0 to 7 > fort 
6. IK comtroller 0 ETE 22091774041 [ES33 917740093 
Enter CL/R:] veetory CSR» mumher of drives for? 
3- Dh comtroller O EN 16091744001 CSI 217752092 
a3» Contr O unit Of is an RLOI/RLOS Che RLOI C33 
33+ Contr O unit t. is am RLOL/ZRLO2 £02 RLOLI CS73 
Enter CL/R:d vectors CSky # drivesy Osoffset recovery/NOeno offset rec. for 
13. UM controller O CN 21091774407 ,07 CSIs v2 
$4. Comtr O urndt O.;. is an RKROG/RNO?Z CO? RKOGI CSA3 
S94. Contr O umit 1. is am RKRO6/RKOZ CO RKOGI CSat 
Enter CL/Ry] veoetors CSKy rmumber of drivesys unit mumber of first drive for’ 
9+ US controller O EU 2049172040990) USI 217209092 
SGN -- Tllesal character in numeric resronse ~--— RETRY 
3» DS controller O KOE 2049172040770) CSa% x2 
U7. Contr O unit O. is am RSOS/RSO4 Ct RSO4] CLSae 
$7. Contr O unit 1. is am RSOS/RSO4 CUE RSO4I CS33 
Enter CL/Ry I veetory CSR» rumber of drives for? 
3. MT comtroller O EN 21491773427 ESA 9177354092 
3. IX combrotler O EM 26491771707 [KSI13 92 


Taregt? MM 


Enter CL/Re ld vectors CSRy cumber of drives fort 


36 MM combroller O £8 22491724407 SN v2 

ole MM controller O urdit OO. formatter CO R&tO-7 T3073 

Sle MM controller O unit de formatter CO RtO87 MTon? 

Narerhueieoad Cegendady devices? CO» Ths The Chey Lity SY 

Erber CLR ye  rmeme Td ’s a2hiey mume THD ose crams UT ee come Ds Port 


19. The terminal deiver UU? LeOsO907 [Sat 93 
EretLer veebore CSE fort 
edie ZL comtroalier O RM? 6091779407 Ewe 


Enter veetory CSky hbishest line number <0 to TS 
Cyangswer sreeecdy DMIIL- BER veoctory DMI BR CSR) for: 


eee QM camtroller O RUE ves 30GG207 
Cie 


mr) 
eee DH cantraller 1 py vy AGO e007 (33 3209160040915 


SIO e 160020915 9 ¥ 3009170500 
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ae 


22 
aa 


+ DH controller 2 CO3 ¢2%30070%01 CSI$ 330216006095 


EQS * To you want tot <CR=-continue R-rereat section E-exit Pe-rause (Si 


End of interrurt vector area has heen set to 400 


‘ap 


ae ow 


: Create Executive huild files 

> IF RSXMC.MAC=LESRSXMCO.MAC/AF 5) > 
> Assemble the Executive 

_ IF Ciliv244/NVeRSXASM.CMDyRSXIIRVASM. CME @ 


-PIF RSXASM. CMI O/TE sy RSXTIRVASM #0 
>REM PIF ~ 


1. To vou wish to edit any of the Executive files? CY/N3 


fag af 4 


www HOT Te we Tee sep var E> 3G ee 9G 


EOS * To vou want to? <CRe-cantinue Re-rereat section E~exit Perause (S1% 


SISET /COFFEERBREAK=TIt Start of Executive assembly at 127317245 on 23—MAY-79 7 

“SET /UIC#£119243 

*MAC @RSXASM 

*§SET /NOCOFFEEBREAK=TIt Executive assembly ended at 12256336 on 23-MAY~-79 rN 
wy ea 
2* EOX * Ttid the Executive assemble correctly? CY/NITY 

>> 

*$SET /COFFEEBREAK=TI?2 Start of device drivers assembly at 12256245 on 23-MaY-79@ 
SSET /UTC#C11%9247 

=MAC @RSXIIRVASM 

*3SET /NOCOFFEEBREAK#=TI? Device drivers assembly ended at 13203355 orn 23-MAY-79 


‘- 


we as as ft 
<> ep a> a> 36 > 


ay 


EOX X Did the device drivers assemble correctly? CY/NILY 


Frerare for task buildins 


SINS SY?$FITF 

SRIF RSX.ORS=*k,.OBJ 

SFPIF &ORJS3k/DE/NM 

SRIF RSXLIM.ORJ/RE=RSX ORS © 
SSET /UICsL i247 

SP IP /NVYel Lis LOURSXBLO. CME 
REM PIF 


wy 
oR EQS & Do vou wank tot <CRD-contirue Rerereat section Frrause €S13 


Ena af SYSGEN ehase £ at 13908154 or 23-MAY79 ain, 
~~ To combtinue tyre? @L200+ 20015 YSGENS 7 “ 


“o> "“4> > «> ~2 


isi 


2@ EOF» 
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& This is the display from the hardware boot of the [1,50] 


unmapped system prior to SYSGEN. 


(2) This is the software boot of the [1,54] mapped system. 


© 


o 


Preparing for SYSGEN; remove the 8K-word indirect, install 
BIGIND (priority of 10 permits other tasks, for example PIP, 
to checkpoint AT.), install BIGMAC (increment of 50000 speeds 
MACRO-1l1 assembly operations), assign the baseline system 
disk to the pseudo device SY:, and initiate SYSGEN. 


Distribution kit variance. If you are performing a SYSGEN 
using the dual RKOS5 kit or the RLO1 kit, SYSGEN mounts and 
assigns the source disk to LB:. If you are performing a 
PREPGEN, you muSt mount and assign the source disk to LB:. 


Big disk distribution kits contain the source files; the 
commands are omitted. 


SYSGEN then installs PIP and displays the number of free disk 
blocks. 


PIP command to append temporary file to the assembly prefix 
file. RSXMC.MAC now contains Executive options’ and 
peripheral components. 


PIP command to copy Executive and device drivers assembly 
command files from [11,10] to [11,24]. SYSGEN then issues a 
PIP command to delete the assembly command files from [11,10] 
and removes PIP. 


At this point, SYSGEN is ready to assemble the Executive. 
Depending on the host processor and the options you selected, 
Executive assembly takes anywhere from 20 minutes to 2 hours. 
You have two options: 


A) Go have some coffee (note that if you responded B_ to 
target question 11, you will probably have some tea). 


B) Read on for methods of correcting DSR space problems 
and some space saving tips. 


A A A 
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If you select A, go have some coffee and read the description 
following note number 8. 


If you select B, read the following. 


During the running of RSX-11M, it is possible to exhaust 
dynamic memory. This can occur if a large number of tasks 
are installed, if many volumes are mounted, of if a number of 
other conditions are present. When you exhaust dynamic 
memory Space, the problem manifests itself in the lack of 
response from the system. Although the system looks like it 
is operating successfully, it cannot accept any MCR commands 
or complete execution of presently running tasks because they 
all require dynamic memory. 


Another manifestation of the problem may be I/O errors’ being 
received by tasks or failures in the Loader due to pool 
allocation failures. The only solution to this problem is to 
bootstrap the system and make more dynamic space available 
(SET /POOL), remove tasks, mount fewer volumes, rebuild FCP 
with space for more file control blocks in its partition, or 
rebuild the system with more dynamic memory. 


The following lists potential methods of saving dynamic 
memory space. 


By including the install, request, and remove on exit 
capability into a generated system, considerable dynamic 
memory may be saved for tasks that are initiated from a 
terminal. The MCR RUN command will install the tasks when 
needed and cause them to be removed when they exit (see _ the 
RSX-11M/M-PLUS MCR Operations Manual). Thus, task control 
blocks need not be permanently allocated. Typical tasks in 
this category are the program development and utility tasks 
provided with the RSX-11M system, (PIP, MAC, TKB, etc.). 


The use of checkpointing and nonresident’ tasks, where 
appropriate, can reduce the number of tasks that are 
simultaneously in memory. This saves space in a mapped 
system, since fewer task headers need to be copied. 


The file system ACP (F11ACP) may be built to store File 
Control blocks in its own task image rather than in the 
dynamic storage region. The more space allocated at task 
build time the less the demand will be on the pool. However, 
if the allocated space becomes used up, the overflow will use 
the dynamic storage region. 


The directory least-recently-used table default is three 
18-word file control blocks. The effect of this table is a 
significant increase in the speed of directory operations. 
If this level of performance is not required, a volume may be 
mounted using the /LRU keyword, thereby reducing the number 
of FCBsS- used. See the description of the Mount command in 


the RSX-11M/M-PLUS MCR Operations Manual. 


Now go have some coffee; SYSGEN is ready to assemble the 
device drivers. When you return, read the description 
following note number 9. 
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At this point, SYSGEN is ready to assemble the device 
drivers. Read the following for the methods of correcting 
DSR space problems and some space saving tips. 


During the running of RSX-11M, it is possible to exhaust 


dynamic memory. This can occur if a large number of tasks 
are installed, if many volumes are mounted, or if a number of 
other conditions are present. When you exhaust dynamic 


memory space, the problem manifests itself in the lack of 
response from the system. Although the system looks like it 
is operating successfully, it cannot accept any MCR’ commands 
or complete execution of presently running tasks because they 
all require dynamic memory. 


Another manifestation of the problem may be I/O errors’ being 
received by tasks or failures in the Loader due to pool 
allocation failures. The only solution to this problem is to 
bootstrap the system and make more dynamic space available 
(SET /POOL), remove tasks, mount fewer volumes, rebuild FCP 
with space for more file control blocks in its partition, or 
rebuild the system with more dynamic memory. 


The following lists potential methods of saving dynamic 
memory space. 


By including the install, request, and remove on exit 
capability into a generated system,. considerable dynamic 
memory may be saved for tasks that are initiated from a 
terminal. The MCR RUN command will install the tasks when 
needed and cause them to be removed when they exit (see the 
RSX-11M/M-PLUS MCR Operations Manual). Thus, task control 
blocks need not be permanently allocated. Typical tasks in 
this category are the program development and utility tasks 
provided with the RSX-11M system, (PIP, MAC, TKB, etc.). 


The use of checkpointing and nonresident’ tasks, where 
appropriate, can reduce the number of tasks that are 
simultaneously in memory. This saves space in a mapped 


system, since fewer task headers need to be copied. 


The file system ACP (F11lACP) may be built to store File 
Control blocks in its own task image rather than in the 
dynamic storage region. The more space allocated at task 
build time the less the demand will be on the pool. However, 
if the allocated space becomes used up, the overflow will use 
the dynamic storage region. 


The directory least-recently-used table default is three 
18-word file control blocks. The effect of this table is a 
significant increase in the speed of directory operations. 
If this level of performance is not required, a volume may be 
mounted using the /LRU keyword, thereby reducing the number 
of FCBs used. 


Now read the description following note number 9. 
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© At this point, SYSGEN has assembled the Executive and all 


selected device drivers. You have had some coffee (or tea) 
and read some tips on conserving DSR space. SYSGEN ihstalls 
PIP to concatenate all existing object files cataloged under 
the UFD [11,24] into a file RSX.OBS. PIP then deletes all 
-OBJ files and renames RSX.OBS to RSX11M.0BJ if you are 
generating an RSX-11M system or to RSX11S.0BJ if you are 
generating an RSX-11S system. 


SYSGEN then changes the UIC and creates a new version of the 


build command file in [1,24] for mapped systems or [1,20] for 
unmapped systems. 


You are now ready to start SYSGEN Phase II and task build the 
Executive and device drivers. 
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CHAPTER 6 


SUMMARY OF SYSGEN PHASE II QUESTIONS 


SYSGEN Phase II is controlled by the command file SYSGEN2.CMD. 
Initiate Phase II by typing 


>@SYSGEN2 


This chapter provides a summary of Phase II. Read Chapter 7 for 
complete details. 


6.1 SUMMARY OF SYSGEN PHASE II QUESTIONS 
1. In what UIC is SGNPARM.CMD if not [current UIC] 
Enter a UIC to override the default specified in Phase I. 
2. Expanded comments desired for SYSGEN Phase II 
Enter Yes for instructions during Phase II processing. 
3. Is SYSGEN still running online 
Enter Yes if performing an online SYSGEN. 
4. Is SYSGEN still running standalone 
Enter Yes if performing SYSGEN standalone. 
5. If not in dev enter object files device when ready (ddu:) 


Enter the device that contains object files (default is 
device specified in Phase I). 


6. Have you already built the libraries, the Exec, and the loadable drivers 


Enter Yes to skip Executive build and start privileged task 
build. 


7. Delete (uic) to insure enough space for SYSGEN Phase II 


Enter Yes to delete mapped system if running unmapped or _ to 
delete unmapped system if running mapped. See Chapter 7. 


8. Create ANSLIB to support Big-buffering 


Enter Yes to create ANSLIB as if ANSI magtape support was not 
included. 
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9. Add the lab device's Purdue ISA routines to library 


Enter Yes to include Purdue ISA routines for IC:, IS:, UD:, 
AR:, or LS: devices. 


10. List Executive map 
Enter Yes to print map of Executive global symbols. 

11. FCP desired (Type <ESC> for explanation) [D:MIDDLE] 
Enter the FCP you wish to include in your system. For mapped 
systems, enter NON-MULTIHEADER, SMALL, MIDDLE, LARGE, PLAS, 
or OTHER. For unmapped systems, enter NON~-MULTIHEADER, 
SMALL, MIDDLE, or OTHER. 

12. SYSPAR's base address in 32 word blocks 


Enter the base address of partition SYSPAR. The default is 
300 for systems that include FCPNMH and 301 if not. 


13. Build the unprivileged queue manager utilities 
Enter Yes to build the nonprivileged queue manager utilities. 
14. Build the task PMD 
Enter Yes to build the Post Mortem Dump task. 
15. Build RMDEMO 
Enter Yes to build the system display task RMDEMO. 
16. Build the non-queue manager print spooler 
Enter Yes to build the serial despooler. 
17. Edit any privileged task build files 


Enter Yes to change partition statements for the privileged 
tasks. 


18. Map device for privileged tasks (ddu:) [D:NL:] 


These maps are rarely needed. Enter a device specification 
if you want them. 


19. Edit SYSVMR.CMD 


Enter Yes if you are generating an unmapped system. If you 
are generating a mapped system, SYSVMR.CMD typically produces 
a valid system image. See Chapter 7. 


6.2 SUMMARY OF LOADABLE DRIVER BUILD PHASE 


The file SGNBLDDRV.CMD controls task builder processing of loadable 
drivers and user-written drivers. 


During Phase II, SYSGEN calls this file to build loadable or 
user-written drivers. However, you can initiate SGNBLDDRV.CMD as a 
command file. If you initiate SGNBLDDRV.CMD, you must answer 
questions 1-5; if SYSGEN calls the file, these parameters are known. 
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Are you building drivers for a mapped system 

Does your system include any user written drivers 

Are you building drivers for an RSX-11S system 

Does your system include the KMC-LP driver 

Does your system have the full duplex terminal driver 
Device for driver's maps 


Enter a device specification for the task builder maps of the 
drivers. 


Spool maps 

Enter Yes if you want the maps spooled. 

Does the map device have at least 120 columns 

Enter Yes for wide maps, No for narrow format maps. 
Build all selected loadable drivers into DRVPAR 


Enter Yes to build all the drivers you selected for the 
system-controlled partition DRVPAR. 


Driver 2-character device mnemonic 


Enter the 2-character device mnemonic for each loadable 
driver you want to build. 


Driver partition name 

Enter the partition name for each driver specified in 
question 10. (Default for mapped systems is DRVPAR. Default 
for unmapped systems is devPAR where dev corresponds to the 
2-character device mnemonic specified in question 10.) 


devPAR's partition base address 


Enter the base address of the specified partition. 


CHAPTER 7 


DETAILS OF SYSGEN PHASE II 


Input to SYSGEN Phase II consists of object and build files’ from 
SYSGEN Phase I. Phase II builds the user-tailored Executive, 
privileged tasks and, if selected, the loadable device drivers. At 
the completion of the task builder processing, SYSGEN Phase II 
attempts to define memory partitions and installs the system image on 
the target volume using the Virtual Monitor Console Routine (VMR). 


SYSGEN Phase II requires four files: RSXBLD.CMD, RSX11M.0OBJ, 
SGNPARM.CMD and optionally, TTDRVBLD.CMD for the full duplex terminal 
driver. These files must exist on the system disk. In addition, the 
files for the UDC, DRS/DSS11, or ICS/ICR-11 common blocks must also 
reside on the system disk if user tasks are going to access the device 
registers. 


The file RSXBLD.CMD directs the Task Builder in constructing the 
user-tailored Executive. SYSGEN Phase I creates this file based on 
your responses, 


The file RSX11M.0BJ is the concatenated object module file produced by 
PIP from the user-tailored Executive object modules following the 
assembly operation in Phase I. 


The file SGNPARM.CMD serves as input to Phase II. This file insures 
that Phase II processing is compatible with the responses from Phase 
I. 


The file TTDRVBLD.CMD directs the Task Builder in constructing the 
full duplex terminal driver. SYSGEN Phase I creates this file when 
you select the full duplex terminal driver. 


Figure 7-1 shows the processing steps that take place during SYSGEN 
Phase II. 
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SY: 


SYSGEN.CMD C5 


SY: 


seNPARM.cMD—={———} 
REX11M.OBJ ——— 


| 
TTDRVBLD.CMD = 


PRIVILEGED = 
SOURCES 


1. Invoke SYSGENZ2. 


2. Answer SYSGEN Phase II 
questions. 


A. Task build the 
executive, 


Target Volume 


B. Task build terminal 
driver. 


C. Task build privileged 
tasks. 


RSX11M.TSK 


Map Listings of: 


D. Generate maps. 


Map Listings Executive 
TT Driver 
Priv Tasks 


$SYTOP 


. Define your memory 
layout (i.e. the relationship 
of the task image and 

system partitions 


Target Volume 


RSX11M.TSK . Load your device drivers, 
set your partition 
parameters, and install 


RSX11M.SYS_ using VMR. 


Processor Memory 


RSX11M.SYS 


5. Boot your system. 


Figure 7-1 SYSGEN Phase II Processing Steps 


CAUTION 


It is likely that you will exhaust RLO1l 
disk space on the mapped (MAPSRC) or 
unmapped (UNMSRC) source disk. This 
prevents successful completion of SYSGEN 
Phase II. Therefore, it is recommended 
that RLO] kit users delete unused driver 
source files (for devices not included 
in the system) from [11,10] before 
beginning SYSGEN. The following lists 
‘seldom-used devices and thus the driver 
source files. 
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Communication devices: 


XBDRV.MAC DA11-B 
XLDRV.MAC DL11-E 
XPDRV .MAC DPll 
XQDRV .MAC DQlil 
XUDRV.MAC DU11 
XWDRV .MAC DUP11 


UNIBUS link 
Serial line 
Synchronous line 
Synchronous line 
Synchronous line 
Synchronous line 


Process I/O and Laboratory devices: 


ICDRV.MAC ICS/ICR11 Subsystems 

IPDRV.MAC IP11/1IP300 Subsystems 

ISDRV.MAC DRS/DSS11 Subsystems 

UDDRV .MAC UDC1l1l Subsystems 

LSDRV.MAC. LPS1ll Laboratory system 
LADRV .MAC LPA11 Laboratory accelerator 


ARDRV .MAC AR11 Analog module 
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In what UIC is SGNPARM.CMD if not [current uic] 


The file SGNPARM.CMD contains the parameters from Phase I that 
are necessary in Phase II. SYSGEN Phase I creates this file in 
the UFD corresponding to the default UIC specified in Phase I. 
Enter a UIC to override the default. 


Expanded comments desired for SYSGEN Phase II 
comments 


Enter Yes if you are unfamiliar with SYSGEN processing; 
provide instructions during Phase II processing. 


Is SYSGEN still running online 


This question appears only if you responded No to Host question 
l. In Phase I, you specified that you were performing an online 
SYSGEN. Enter Yes if that remains true. 


Is SYSGEN still running stand-alone 


This question appears only if you responded Yes to Host question 
Ls In Phase I, you specified that you were performing a SYSGEN 
using the baseline system. Enter Yes if that remains true. 


If not in dev enter object files device when ready (ddu:) 


This question appears only if you are using a dual RKO5 or an 
RLO1 distribution kit. Enter the device that contains the object 
files. Note that the default device is the device for the source 
files specified in Phase I. Enter a device specification if you 
have moved the disk to another drive. 
If you are using a single RLO1l drive and have not 
object files, enter No or None. 


copied the 


Have you already built the libraries, the Exec, and the loadable drivers 


Note that SYSGEN truncates this question if you did not’ select 
loadable driver support; you are not asked whether or not the 
drivers were previously built. 
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This question asks whether or not the Executive has been linked 
together by the Task Builder. SYSGEN Phase I does not link the 
Executive, it only assembles it. Therefore, the first time you 
encounter this question, it should be answered negatively. 


Typically, before a partition can be laid out for unmapped 
systems, the user needs a Task Builder map of the newly built 
user-tailored Executive. This occurs later in SYSGEN2.CMD and 
may require a lengthy off-line analysis of the partition layout 
for the target system. After analyzing the partition layout, 
SYSGEN2.CMD can be re-initiated. If, at this point, an 
affirmative answer is typed, the process of building libraries, 
device drivers and user-tailored Executive is skipped, and 
SYSGEN2.CMD advances to the dialogue to build the privileged 
tasks. 


If you respond Yes to this question, SYSGEN skips questions 7-10. 
Delete (uic) to insure enough space for SYSGEN Phase II 


This question appears only if you are using a dual RKOS5 
distribution kit. 


Disk space on the dual RKO5 kits is critical. To avoid the 
possibility of running out of free disk blocks, you should enter 
Yes to this question (see the Caution below). 


If you are generating an unmapped system and you respond Yes to 
this question, SYSGEN deletes the files for a mapped system (in 
[1,54]) from the baseline system disk (RSXM26). 


If you are generating a mapped system and you respond Yes to this 
question, SYSGEN deletes the files for an unmapped system (in 
{1,50]) from the baseline system disk (RSXM26). 


CAUTION 


If you are generating a mapped system 
using an unmapped system (for example, 
you booted the unmapped baseline system) 
and you delete the unmapped system 
image. You have destroyed your disk. 
You must make another copy of the 
distribution kit and reboot. Likewise 
if you are generating an unmapped system 
using a mapped system image and you 
delete the mapped system. In other 
words, if you are running standalone, do 
not delete the running system image; 
generate an unmapped system using = an 
unmapped system image and generate a 
mapped system using a mapped system 
image. 


Create ANSLIB to support Big-buffering 


If you did not select ANSI magtape support in Phase I, this 
question permits you to get big-buffering FCS support. When you 
enter Yes, SYSGEN creates ANSLIB as it would if ANSI magtape 
support was included. 
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Add the lab device's Purdue ISA routines to library 


This question permits you to include the Purdue ISA routines with 
Ic:, IS:, UD:, AR:, or LS: devices. See the appropriate device 
documentation for more information. 


List Executive map 


The Executive map defines the Executive global symbols and their 
locations in memory. These locations are used to layout 
partitions. If you are generating a large mapped system, the map 
is not necessary. If you are generating an unmapped system, the 
map is required so that you know where to build the drivers. 


If you respond Yes, SYSGEN prints or spools the map on the _ line 
printer (if the system includes one) or terminal. 


FCP desired (Type <ESC> for explanation) 


This question appears only if you selected Files-1l support in 
Phase I. 


Mapped RSX-11M systems Support five versions of the file system: 
@e 2K-word non-multiheader (disk overlayed) 

e 2.25K-word multiheader (disk overlayed) 

e 5K-word fast multiheader (disk overlayed) 

e 6.5K-word optimized multiheader (disk overlayed) 

@e 10K-word resident (memory-resident overlayed) 


Unmapped RSX-11M systems support three versions of the file 
system: 


@e 2K-word non-multiheader (disk overlayed) 
e 2.25K-word multiheader (disk overlayed) 
e 5K-word fast multiheader (disk overlayed) 


This question permits you to select the FCP best suited to your 
application needs and memory limits. 


The non-multiheader version (FCPNMH) is the minimum size F11ACP, 
This FCP restricts files to a maximum of 26,112 blocks of 512 
bytes (no multiheader files) and does not support RMS~ record 
locking. Use FCPNMH with DECtapes, floppy disks, or with small 
unmapped systems; additional use in a large or multiuser system 
is not recommended. SYSGEN builds FCPNMH to run in partition 
SYSPAR, which is 10000(8) bytes long. For unmapped systems, 
SYSPAR starts at 30100(8). If you want to change partition 
parameters for FCPNMH, you must edit the build command file. 
Enter NON-MULTIHEADER to select this version. (FCPNMH is the 
default for unmapped systems.) 


The multiheader version (FCPSM0O) is a full functionality and 
heavily overlayed FI1ACP. Use FCPSMO with a small memory system. 
Enter SMALL to select this version. 
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The fast multiheader version (FCPMD1) stores as many File Control 
Blocks (FCBsS) as possible in its task image before overflowing 
into the dynamic storage region. Use FCPMD1 for applications 
which use the file system in a heavy open/close and read/write 
environment; this version treats file creates, deletes, and 
extends as secondary operations. Enter MIDDLE to select this 
version, (FCPMD1 is the default for mapped systems.) 


The optimized multiheader version (FCPLG1) is a larger, less 
overlayed F11lACP and is not supported on unmapped systems. This 
version limits disk overlay activity to exception cases and file 
deletions. Use FCPLG1 for development systems and in 
applications which extensively use the file system to create and 
extend files. FCPLG1 is recommended for systems without strict 
memory limitations as well as an alternative to a memory resident 
structure for systems with limited memory. Enter LARGE to select 
this version. 


The resident version (FCPRO2) is supported only on mapped systems 
that include Executive support for memory management directives 


(PLAS). This version eliminates disk overlay activity. Use 
FCPRO2 for development systems and other high performance systems 
that extensively use the file system to manipulate files. Enter 


PLAS to select this version. 


When you select the FCP that best fits your memory limits, you 
can consider Task Builder options that improve FCP performance. 
For all versions except FCPNMH, the distribution kits include 
multiple build command files for the FCPs. This permits you to 
tailor an FCP, but does not require you to edit the build command 
files. To build a tailored FCP, enter OTHER in response to this 
question; SYSGEN will pause prior to building the privileged 
tasks to allow you to specify the FCP build command file that 
best suits your application needs. The following lists the FCP 
build command files and summarizes the task builder options of 
each. . 


FCPNMHBLD.CMD 


Size: 2.0K 
No task builder options 


FCPSMOBLD.CMD 


FCBs: 0 
Shared directory buffer: 1 block 


FCPSM1BLD.CMD 


Size: 2.75-3.0K 
FCBs: 32 
Shared directory buffer: 1 block 
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FCPMDOBLD.CMD 


a Size: 3.6-4.0K 
FCBs: 0 
Shared directory buffer: 1 block 


FCPMD1BLD.CMD 


Size: 5.0-5.25K 
FCBs: 32 
Separate directory buffer: 3 blocks 


FCPMD2BLD.CMD 


Size: 6.1-6.4K 
FCBs: 64 
Separate directory buffer: 5 blocks 


FCPLGOBLD.CMD 
Size: 4.75-5.0K 
FCBs: 0 
Shared directory buffer: 1 block 
. FCPLG1BLD.CMD 
Ce” 


Size: 6.4-6.7K 
FCBs: 32 
Separate directory buffer: 4 blocks 


FCPLG2BLD.CMD 


Size: 8.3-8.6K 
ey FCBs: 64 
ies Separate directory buffer: 8 blocks 
Also includes separate buffer for index file bitmap 


FCPLG3BLD.CMD 


. Size: 9,6-9.9K 
FCBs: 128 
Separate directory buffer: 12 blocks 
Also includes separate buffer for index file bitmap 


FCPCOOBLD.CMD 


Size: 6.0-6.25K 
FCBs: 0O 
% Separate directory buffer: 0 blocks 
\ Pp yY 
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FCPROOBLD.CMD 


FCBs: 0 
Separate directory buffer: 1 block 


FCPRO1LBLD.CMD 


FCBS: 32 
Separate directory buffer: 4 blocks 


FCPRO2BLD.CMD 


Size: 9.8-10.1K 

FCBs: 64 

Separate directory buffer: 8 blocks 

Also includes separate buffer for index file bitmap 


FCPRO3BLD.CMD 


Size: 13.0-13.25K 

FCBs: 123 \ 

Separate directory buffer: 12 blocks 

Also includes separate buffer for index file bitmap 


For systems with several high-performance disks, it is possible 
to increase file system throughput by mounting each volume with a 
separate F11ACP. Distinct ACPS allow a Separate pool of FCBs for 
each disk volume in each FIL1ACP partition, and allows overlapping 


directory requests on each volume. The ACP default name 
algorithm of the Mount command simplifies specifying separate 
ACPs (see the RSX-11M/M-PLUS MCR Operations Manual). For 


example, if your system includes DECtape, install a separate 
version of FIllACP (the non-multiheader version, FCPNMH, is 
adequate for DECtapes) with the name DTO1F1, the primary default, 
or DTAACP, the secondary default. 
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NOTE 


It is recommended that file system not 
share a user-partition with tasks that 
perform file-structured I/0, especially 
in systems with minimal user memory. 
The operation of RSX-11M is heavily 
dependent on the file system. Nearly 
all tasks request processing from it. 
Thus, for a system to operate properly, 
the file system must be in a partition 
where it can react promptly. Most tasks 
request an I/O operation through FI11ACP, 
and while this I/0 operation is in 
progress, the tasks cannot be 
checkpointed. Thus, if F1l1IACP is 
running in the same partition, it may 
not be able to be loaded into memory to 
process the request and a deadlock 
situation can occur. 


SYSPAR'sS base address in 32 word blocks [100:1700:N] 


This question appears for unmapped systems only. Note that’ the 
default response (N) is determined by the FCP you selected (300 
for FCPNMH, 301 for another FCP). 


SYSGEN uses the response to this question in a nominal attempt to 
ease user burden in an unmapped system generation. SYSGEN 
creates a file (SYSPAR.CMD) which contains the base address’ and 
length of parition SYSPAR. However, SYSGEN cannot determine the 
exact location for partition SYSPAR. You should consult the map 
of the Executive to determine where the Executive ends and thus 
where to begin SYSPAR (symbol SSYTOP in the map of the Executive 
is the highest Executive location). 


Build the unprivileged queue manager utilities 

The response to this question specifies whether or not’ the 
nonprivileged queue manager utilities are built by Phase II. 
Appendix D describes the queue manager. 


Build the task PMD 


The response to this question specifies whether or not the Post 
Mortem Dump task is built by Phase II. The RSX-11M/M-PLUS Task 
Builder Manual describes the PMD task. 


Build RMDEMO 


The response to this question specifies whether or not the RMDEMO 
task is built by Phase II. Appendix B describes RMDEMO. 


Build the non-queue manager print spooler 
If you did not select support for the queue manager in Phase I, 


this question permits you to build the serial despooler (V3.1 
spooler). 
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The serial despooler prints listings simultaneously with the 
operation of other tasks. The MACRO-1l assembler, Task Builder, 
and FORTRAN compilers try to spool all listings or map files to 
disk. If neither the serial despooler nor the queue manager are 
installed, the files remain on disk. If the serial despooler is 
installed, it is started and thus prints any files in its receive 
list. 


For optimum operation, the serial despooler should occupy its own 
2K partition, although this is not necessary if the GEN partition 
is large. It can be built checkpointable or not checkpointable. 


Under normal circumstances, the serial despooler deletes only a 

small class of files after printing. You can build a deleting 3 
serial despooler by editing the task-build command file 
PRTBLD.CMD; locate the line GBLPAT=PRT:SDELET and change it to 

read GBLPAT=PRT:S$DELET:1. 


You may supply an alternative file deletion algorithm and include 

it in task PRT. The module should define the global entry point 

SDELCK. The routine is called with register RO containing the 

FDB of the file just printed. On return, RO must be preserved , Ns 
and the processor status C-bit should be set to indicate that the ned 
file is to be deleted. 


Use of this feature bypasses all of PRT's default file deletion 
logic. To include this module, insert it in the object library 
PRT.OLB, and edit the task-build command file PRTBLD.CMD, 
deleting the following line: 


GBLDEF=S$DELCK: 0 


Before a file is printed, an identification page is generated. aa, 
This page contains the RSX-11M version number; the date and . 
time; and the device, UFD, and name of the file being printed. 

In addition, the file name is printed in large block letters for 
readability. Two .formats are available, a large one for 

132-column printers, and a smaller one for 80-column printers. 


You may build PRT to omit the file identification page by 
Modifying a global patch in the task-build command file as 
follows: 


*F GBLPAT=PRT:SFLAG 
GBLPAT=PRT: SFLAG:1 
*C/1/0/ 
GBLPAT=PRT:SFLAG: 0 


Note that the value specified in the GBLPAT statement is used _ to 
determine the number of title pages’ printed. There are 
additional options for specifying flag page size and the number 
of trailing form feed characters to be printed. The task-build 
command file, PRTBLD.CMD, contains detailed commentary concerning 
these options. 


SYSGEN then displays a list of the build files for the privileged 
tasks to be built and asks question 17. 
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Edit any privileged task build files 


A Yes response causes SYSGEN to pause to allow selective editing 
of the privileged task build command files. 


For mapped systems, it is not required that you edit the task 
build command files. 


For unmapped systems, you may have to edit the privileged task 
build command files so that the partition statements reflect 
actual base addresses. All of the tasks to be built have’ task 
build command files that specify either partition SYSPAR, GEN, or 
PAR14K. You specified the base address of SYSPAR in question 12. 
Thus you do not have to edit the SYSPAR partition statement. 
Partition GEN is assumed to be based at 40000(8) and to be 
40000(8) bytes long. You must edit the build command files if 
this assumption is inaccurate. Also, partition PAR14K is assumed 
to start at 40000(8) and to be 70000(8) bytes long. 


The privileged tasks must always be rebuilt when the Executive 
has been rebuilt. The privileged tasks are linked to the 
Executive symbol table file and map into the Executive address 
Space so that they may access various system lists and data 
structures. If the Executive is changed, these addresses change; 
thus, the tasks have to be rebuilt. 


The Line Text Editor (EDI) may be used to examine the PAR command 
line in each file that may require modification. Every file in 
question must be checked, since a Partitions command which does 
not reflect the requirements of the user-tailored system can 
produce tasks which will not run or could crash the system. 


For an unmapped system, tasks built to run in SYSPAR have the 
proper task builder command. Those built to run in the GEN 
partition specify 


PAR=GEN: 40000: 40000 
For mapped systems, the respective commands are: 


PAR=S YSPAR:0:10000 
PAR=GEN:0: 40000 


If alteration is necessary, the change may be accomplished as 
shown below. Suppose, for example, the GEN subpartition is to 
start at 50000(8). The above Sequence would be changed to: 


>EDI BOOBLD.CMD 
[PAGE 1] 

*L PAR 

PAR=G EN: 40000: 40000 
*C/IN 24:5 

PAR=G EN: 50000: 40000 


* EX 

[EXIT] 
There are two versions of MCR: a Single user version, MCR; and 
a multiuser version, MCRMU. The single user version processes 
commands serially and runs in partition SYSPAR. The multiuser 


version consists of two tasks, MCRMU and “SYS. Task MCRMU 
receives commands in serial, but passes most on to task SYS _ for 
processing. The multiuser version achieves a degree of 
parallelism since multiple copies of task SYS can be running (one 
for each terminal). Task MCRMU runs in partition SYSPAR while 
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task SYS runs in GEN. Edit the task build command files’ to 
change partition statements. (Note that MCRMUBLD.CMD controls 
the task-build of both MCRMU and SYS.) 


The default partition for TKTN is SYSPAR. Normally, you need not 
edit the build command file. 


The tasks BOO, DMO, AT., INI, INS, LOA, MOU, SAV, UFD, and _ UNL 
build to run in GEN. For unmapped systems, you will have to edit 
the build command files if partition GEN does not start at 
40000(8). 


Map device for privileged tasks (ddv:) [D:NL:] 

Usually, these maps are of little use to the mapped system user 
and are not needed. The default response directs the maps to the 
null device. For an unmapped system user, the maps are of use if 
you want to determine the exact size of the tasks. 

If you want the maps, enter a device specification. Note that if 
you enter other than LP:, SY:, LB:, TI:, or TT:, the device must 
be mounted and a UFD entry of [1,30] for unmapped systems or 
[1,34] for mapped systems must exist. 

Edit SYSVMR.CMD 


SYSGEN Phase II creates a file (SYSVMR.CMD) to create the 
partition structure, install tasks, and load loadable drivers. 


This question permits you to edit the SYSVMR.CMD file. 


For mapped systems, it is not necessary to edit this file; 


although it may not produce an optimal system on_ small 
configurations. SYSVMR.CMD typically produces a valid mapped 
system image. The following depicts a mapped system partition 


structure that results from executing SYSVMR.CMD 
DEV common 
(optional) 
FCPPAR 
(optional) 
SYSPAR 


DRVPAR 
(optional) 


TTPAR 

(optional) 

LDRPAR 

(optional) 
pean 
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For mapped systems, SYSVMR: 


® Extends pool space to the maximum size of the Executive 
(either 16K or 20K). If you do not want to use the 
Maximum amount of pool, edit SYSVMR.CMD; locate the line 
SET /POOL=* and change the wildcard specification to use 
the value of SSYTOP rounded up to the next 32-word block. 


o If you selected the loadable loader, creates the partition 
LDRPAR and installs and fixes the loader in it. 


® If you selected the full duplex terminal driver, creates 
partition TTPAR and loads the terminal driver into it. 


® If you selected loadable drivers, creates partition DRVPAR 
and loads all loadable drivers built during the running of 
Phase II into it. If you do not want to load all drivers, 
edit SYSVMR.CMD; delete the load command for each driver 
you wish to exclude. Note that you should load the system 
disk driver first so that you can boot the system from an 
unmapped system. 


NOTES 


If you are restarting SYSGEN Phase _ II 
(you responded Yes to question 6), 
SYSGEN cannot determine which drivers 
were built for the system. Therefore, 
you must edit SYSVMR.CMD and insert’ the 
load commands for the drivers. 


SYSGEN uses wildcards (*) to create 
DRVPAR'S size as _ the sum total of all 
drivers loaded at VMR time. If you wish 
to allow space for other drivers, edit 
the partition statement and specify 
sufficient space. 


Rather than delete command lines’ that 
load drivers that you do not need, it is 
Suggested that you insert a semicolon 
(;) at the beginning of the line. (VMR 
treats such lines as comments.) 


® Creates partition SYSPAR and, if you selected FCPNMH, 
installs FCPNMH into it. 


® If you selected other than FCPNMH, creates partition 
FCPPAR and installs the FCP. 


® Creates partition GEN (from end of last partition to top 
of memory) 


o If you selected direct access to device registers’ for 
IP11/1P300, ICS/ICR, UDC1l1, or DSS/DRS devices, creates 
DEV common, which overmaps the I/O page to permit direct 
access to the device registers. 


For unmapped systems, it is not possible for SYSVMR.CMD to create 
an optimal partition structure; ° you must edit SYSVMR.CMD. The 
following depicts an unmapped 16K to 24K system that results from 
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executing SYSVMR.CMD. Note that for unmapped systems, SYSVMR 
does not create driver partitions. 


devPAR 


1000 


400 


300,301 


For unmapped 16K - 24K systems, SYSVMR: 


e If you selected other than FCPNMH, establishes the top of 
pool and the Executive at location 30100. If you selected 
FCPNMH, establishes the top of pool and the Executive at 
location 30000. 


e Creates partition SYSPAR. The base address, and thus’ the 
length, depends on the FCP you selected. For FCPNMH, 
SYSPAR starts at 30000 and is 10000 bytes. For other than 
FCPNMH, SYSPAR starts at 30100 and is 7700 bytes. 


e Creates partition GEN and attempts to install all tasks 
into it. 


The following depicts an unmapped 24K-28K system that results 
from executing SYSVMR.CMD. Note that for unmapped systems, 
SYSVMR does not create driver partitions. 


FCPPAR 
(optional) 


PAR14K 


SYSPAR 


300,301 
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For unmapped 24K-28K systems, SYSVMR: 


e Establishes the top of pool and the Executive at location 
30100 for other than FCPNMH or at location 30000 for 
FCPNMH. Be sure that this location is above the Executive 
(for example, SSYTOP). 


e Creates partition SYSPAR. The base address, and thus'7 the 
length, depends on the FCP you selected. For FCPNMH, 
SYSPAR starts at 30000 and is 10000 bytes. For other than 
FCPNMH, SYSPAR starts at 30100 and is 7700 bytes. 


e Creates partition PAR14K (base address is 40000, length is 
70000 bytes) and a subpartition GEN (base address is 
40000, length is 40000 bytes). 


e If you selected other than FCPNMH, creates’ partition 
FCPPAR. 


7.2 DETAILS OF LOADABLE DRIVER BUILD PHASE 


This section provides details for SYSGEN processing of loadable driver 
task-build command files. 


The file SGNBLDDRV.CMD controls the task building of loadable drivers 
and also permits incorporation of user written drivers. 


This command file executes during SYSGEN Phase II when your’ system 
includes loadable drivers or if you specified that you wish to include 
a user written driver. Note that the file can be used by itself to 
aid in task building (or re-task building) drivers. 


If you initiate SGNBLDDRV.CMD, you must answer questions 1-5; if 
SYSGEN calls the file, these parameters are known. 


1. Are you building drivers for a mapped system 

2. Does your system include any user written drivers 

3. Are you building drivers for an RSX-11S system 

4. Does your system include the KMC-LP driver 

5. Does your system have the full duplex terminal driver 
6. Device for driver's maps 


Unmapped systems require these maps. If you are generating an 
unmapped system, the default map device is SY:. 


Typically, mapped systems do not require these maps. If you are 
generating a mapped system, the default map device is NL:. 


NOTE 


If you want (or require) the maps-~ and 
specify a device other than SY:, LP:, 
LB:, TT:, or TI:, SYSGEN requires’ that 
the device be mounted, ready, and that 
the proper UFD ([1,30] for unmapped, 
-(1,34] for mapped) exists. Also, the 
driver must be loaded. . 


7. 


8. 


9. 


10. 


ll. 


12. 
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Spool maps 


This question does not appear if SYSGEN calls SGNBLDDRV since you 
specified whether or not to spool listings and driver maps in 
Phase I. 


Does the map device have at least 120 columns 


This question does not appear if SYSGEN calls SGNBLDDRV since you 
specified whether or not the map device has 120 columns in Phase 
Le 


If you enter No, the task builder uses the /-WI switch to print 
narrow maps. 


Build all selected loadable drivers into DRVPAR 


This question appears for mapped systems only. Normally, all 
loadable drivers in a mapped system are built to run in partition 
DRVPAR. 


If you enter Yes, SYSGEN builds all the loadable drivers you 
selected in Phase I for partition DRVPAR. 


If you enter No, SYSGEN prompts for the drivers you want to build 
(see question 10). 


Driver 2-character device mnemonic 


This question appears for unmapped systems and all systems’ that 
include user written drivers. The question also appears if you 
are generating a mapped system, but do not want to build all 
selected drivers or if you wish to build mapped loadable drivers 
for other than partition DRVPAR (responded No to question 9). 


Enter the 2-character device mnemonic for each loadable driver 
you want to build. SYSGEN then prompts for the partition name 
(in question 11). When complete, enter carriage return. 

Driver partition name 


The default for mapped systems is partition DRVPAR. 


The default for unmapped systems is partition devPAR where dev is 
the 2-character device mnemonic specified in question 10. 


For unmapped systems, consider building the system disk driver 
for the partition that corresponds to 2-character device 
mnemonic. This is also recommended for other drivers that run in 
their own partition (for example, TTPAR). A suggested partition 
name for less frequently used drivers is DEVPAR. You can Load a 
driver as you need it (after unloading other drivers). 


devPAR's partition base address 
This question appears for unmapped systems only. 


Enter the base address of the specified partition. 
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7.3 DETAILS OF SYSGEN PHASE II PROCESSING | 


During a system generation, SYSGEN issues command lines and displays 
comment lines. This section uses the console listing from the SYSGEN 
described in Chapter 5 to detail and describe the command lines as 
well as interpret the more obscure comment lines. 


The console listing appears below. It is followed by notes which are 
keyed to the listing. 


4, 
- 


@ 
a 
y 
a 
y 
a 
9 
oF 
*F 
ory 
wy 
>3 
2k oO. 
we 
23 
a] 
Sy ; 
9 
ok Ze 
2K 4, 
XK 3 . 


SYSGEN2 


RSX-11M Version 3.2 BL26 Sustem 
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Generation Phase IT 
Coryrisht (0) 1978 Tisital Eauirment Corrorations Maynard Mass. 


SYSGEN Fhase II started at L3tL0Ot31 aon 23-MAY-79 


In what UIC is SGNFARM.CMD if mot £C2007%200] S12 


Continuation 


RLO1 distribution kit 


SYSGEN versions 3.2.2c / 223.2.2¢ 


from SYSGEN ehase I done om 23-MAY-79 at 13208318 


xeranded commerrts 


If not in 


desired for SYSGEN frhase IT? CY/NI% 
Is SYSGEN still running stand-alone? CY/NISY 
Thi? enter object files device when reads (ddut) CS7% 


MOU -~ OTHER VOLUME MOUNTEX - Dat 1) 
SASN DLIt=LEs 
SASN SYteTKS 
INS SYI$PIF 
>PIF /FR 


NLO HAS 2957. 
LARGEST CONTIGUOUS SFACE 


2K &. Have you already built the lihraries» the Execs and the loadable drivers? CY/N1$3 


Vv ¥ 
> ~> “> we «> @ 


Create system 


*INS $LER 

SET /UIC#Cix1) 
“PTF ANSLIRB.OLB/NV=SYSLIB.OLE @ 
>LBR ANSLIB/RP=LBESFCSMTA 


MODULE 
MODULE 
MODULE 
MOTWLE 
MODULE 
MODULE 
MODULE 
MODULE 
MOQUIE 


MOTULE 


MOTIULE 
MODULE 
MODULE 
MOTE 
MODULE 
MOTUWLE 
MOU: 


MOXQUILE 


"ANSFAL" 
"ASSLUN" 


"“BIGRUF * 


"CLOSE " 


"CREATE *® 
“QUIRECT" 
"GET " 
"GETSQ ° 
"OREN ° 
"ORFF IG * 
"“QOPENE " 
“POINT " 
"PUT : 
“FUTSQ * 
"RYIWA LT " 
"RE TATIR " 
"RWELK ° 
“WATSET " 


"WTWATT® 


BLOCKS FREE» 7283. BLOCKS USED 


= 2750. BLOCKS 


Start of Executive and driver huild ehase at 


lihraries 


REFPLACEL 
REPLACED 
REPLACED 
REPLACED 
REPLACET 
REFLACED 
REPLACED 
REPLACE 
REPLACES 
REPLACE 
REPLACED 
REPLACED 
REPLACE 
REPLACE 
REPLACE! 
REPLACE 
REPLACE I 
REPLACE 


REPLACED 


OUT OF 10240, 


13311344 on 23-MAY-79 
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SSET ZUTCeENL 24) 

SFIF RSXLIM. OLB? k/DE/NM 

SLBR RSXLIM/CR 280.2640. $256.20 11 9241 RSX1IM.ORJ 3] 

REM PIF 

SINS SY2$RIGTKE 

INS ~~ PARTITION FARLAK NOT IN SYSTEM, DEFAUL TING TO GEN 


uy 

2) Taskbuild the Executive 
mY 

INS SYI$PIF 

>PIF C12340K.KdK/DE/NM @ 
>REM PIP 

>TKE @RSXBLD 


re) 
2K EOX * Did the Executive build successfully? CY/NAVLY 
“9 


SSET /UTCEE Ls S42 

*INS SYt$PIF © 

SPIF LBs ZNVeERSXLIM. STR 

SREM FF 

SINGS SYISFETF 

2K 10+. List Executive mar? DY/NA2 


Build Loadahle drivers 


4&. Tevice for driver’s mars CMS NLta Coa: 
2K OF Budle @1]1 selected loadable drivers into TRVFAR? CY/NIZY 


SBET /UICHD1 24) 

STKE @L2007 2007 TTORVELE 

>EIF £2007 2007 TTIRVELD. CMI X/ DIE 
PIF Cie S41 TTORV.STR/TR 

“TRE @0200 72001 0RURVELE 

ZEIF £200 200] 0ERURVELI. CMDS K/DE 
PPIP CleS4 1 0E0RV.STB/TR 6) 
STKE @£200% 2007 0KDRVBLI 

“PIF C200» 200 0KIRVBLIE. OMI */TIE 
>EIF C1954 0KURV,STR/TR 

STKE @£200» 2007 DLURVBID 

PIF £200» 2007 DLURVELIO. CMDs K/DE 
SPIF Cl y S41 0LLRV.STB/TR 

TRE @0200» 200] 0MDRVELE 

SE IF £200» 200 TUMIRVEL DO. CMI K/TE 
SRIF C154 70M0RV,STR/TR 

>TKE @£200» 200 I NSIRVELD 

£200» 200 0SNRVBLU. CMD K/TIE 
[PTE C1954 1DS0RV.STR/TR 

“TRE @0200% 200 JNTORVELL 

£2007 20070 TORVBLO CMI K/ TE 
2EIE Cle S410TORY. STR/TR 

TRE @0 200» 200 TUXDRVEL 

£2007 200 70XLRVBLIO. CMG K/ TE 
mPFC y $4 0X0RY . STB/TR 

STKE @L20072007LEURVELI 

SELF £200» 200 LPORVRL I. CMD EX/ DE 


SPEIP Ce S41 Le nky STB TER 
TRE OF 2002 200 MMIRVELM 
PE 2009 2OOUMMIRY BLT. COMI KATIE 
My S4 MMR. STB TR 


Enet of Litrarcuy Executive and driver budid ehagea at L3t25t50 on 23-MAY-79 


Taek Budde the erivilesed tasks 

ti. FOF desired  CTuree ESOS for exelanation) EOS MINGLED Coca 
13. Budde the unerivilesed aueue manager utilities? EYZNULY 

14.6 Buide the tack PMI? EYZNU2Y 

19. Budde RMDEMO? EVANS ¥ 

V7. Echt ane erivilesecd task onudild files? EY/NAt 

18. Mar cevice for erivilesed tasks Coedut> Pet Nod ose 


oy 
we 
ob 
oo 
og 
ook 
OK 
ok 
ok 
OK 
wk 
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ar.’ 


ad 

PAGSN NL 
“AGN LE 
SASN = 
SAGN &S 
“ASN DLL eSy 

SAGN TLOeL Be 

“TKE @ROORLD 

“TRE @OMOBLE 

=TRE @FCPMIA EL 

*TRE @INDBLY 1 GENERATING SMALL. INDTRECT 

“TKE @INTIBIN 7) 
STKE @INSBILD 

=TRE @MCRMUBLO 

=TRE @MOUBLD 

*TRKB @QMGBILL 

TRE @QMGCLIBLI 

=TRE @QMGFRTELO 

2TRE CLEP BLO 

TRE @FIIMSGRLE 

=TRE @MTABLE 

“TRE @SAVELE 

“TRE @TKNELD 

“TRE @UFTIBLY 

“TRE @LOABLID 

“TRE @UNL BLD 

“TRE @FPMDBLE 

“TRE @RMUBLI 

“TRE @SHFEBILN 

“TRE. GACNTBLI 

“TRE @BYERBL 

*TKB @HELBLD 

>TKE @ERROBLD 

>TRE @SHUTUPRLD 

*TKB @ACSELYD 

STKE @ERFRLE 

*TKE GERLBILT 


ay 
7k EOX * Did the rrivilesed tasks build successfully? CY/NItTY 
ey 


“REM TKE 

=ASN LEt=Syi 
“ASN =LE? 

*ASN =SY% © 
ZASN DILOt#SY 3 
“ASN DLE =L Be 
SBET /UIC#E1» 
SPIFO /FR 


343 


BLO? HAS 1253. BLOCKS FREE, 8987, BLOCKS USED OUT OF 10240, 
LARGEST CONTIGUOUS SPACE = 1017. BLOCKS 


SGN -~ SYSGEN will now eause to allow you to create wour 
RSXLIM.SYS file using the following examele. Ideally 
your SuSstem it should occury the same mumber of blocks 
as indicated in the examele, 


“|> E> ap “E> “E> “E> “Eo 


PIF RSXLIM+SYS/NV/CO/EL 3 499.2RSX11M. TSK 
AT. -=- FAUSING. TO CONTINUE TYPE "RES «.-+AT." 9) 
PILE RSXITIM+SYS/NU/CO/BL 3 498.2RSX1LIM. TSR 

RES 46 + ATS 

ATs one CONTINUING 


REM Fy 


cae) 
SK O19. Echit SYSYMR CMI LYN 


“ING SYSSBOO3~1. 
SINS SUM G1. © 
PASN SY esis 

oVME 


nS 


wy 
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ENTER FILENAME? @SYSUMR 
pile wm INSTALLED ate MAY NO LONGER FIT IN PARTITION 11) 
SET 7 TOP SQRVEAR $ 
FOOL: EL2O008 easontoRauGs 
LURPAR 117734 00120000 00002400 MAIN TASIN 
DRVFAR 117420 00122400 00030400 MAIN SYS 
LA7 34 OO122400 00002000 SUB TIRIVER — TBS 
OO124400 OOOOLLOO SUB DRIVER ~ TN? 
OOL2]5500 90002100 SUB TRTVER ~- DL? 
OO127600 00002500 SUB TIRTVER ~ KMs 
116754 QOLSRSOO 00001000 SUB DRIVER ~ US3 
L146654 00133300 00001100 SUR RIVER - nT? 


L1I6384 

116454 

116394 

416254 
SYSFAR L1S654 
FCRFAR TLS610 
GEN 115544 
ee eh OR 14 


TKTN 

oe RMD 
MTAACE 
oo o CMD 
MOR 6 ++ 
eee MOU 
ee MOR 
FACE 
MIs os 
SHF ee 
eee TNS 
+e ¢ SAY 
eo e UD 


QMGs «+. 


PRT soe 
L.PRO 
+ 4° > AT + 
eee ERE 
eee INT 
+ @ QUE 
eee PRE 
1 e ACS 
ee ROO 
ERRLOG 
ooo LOA 
oe HEL 
1 e (BYE 
ee UNE 
LPO $s 
NBO $ 
Teeth $ 
NR2: 
TUR 2 
DING 3 
1 Ne es 
TH 3 
TKS 3 
THL.G 3 
TH ¢ 
TMG & 
TM 13 
NSO 8 
Ce 3 
MTG 3 
OTe 
X03 
UX 1s 
MMOE 
MMs 
TTO3 
TTS 
TTR 
TVS3 
TT4¢ 


O35 6 OM 
VOl 
0010 
ane QQ 
ORO 
mato LS 
Ol 
MOBRO 
OS 

04 

O4 
04.22 
VO4ALO 
O1.04 
O1-.O0 
O1+96 
94.25 
OR? 
20401 
1+9 
1.49 
on 
03.4 
On 

O35 63 
O1.24 
O26 1 
O72 6 B 


AE 


. OA CIE 


| 
| 
(Qe Coe 1 
| 
LCA Cate Td 


00134400 
001346000 
00137100 
00143000 
00153000 
00163000 
00207000 
117634 


LOR FA 


00001400 
90001100 
00003700 
00010000 
00010000 
00024000 
aa 
248, 


L12344 BAAS 248. 
1144644 GIN Rae 
114044 GEN 200. 
114344 GEN 160. 
113244 SYSFAR 1460. 
412744 GEN 160. 
112444 GEN 149. 
115444 FCFEPAR 149, 
113444 GEN 140. 
112544 SYSFAR LOS. 
L13844 GEN 100. 
112644 GEN 100, 
112244 GEN 100. 
115344 GEN 755 
113044 GEN 79-6 
114744 GEN 70-6 
413744 GEN SS 6 
114244 GEN 61. 
113644 GEN 40+ 
115244 GEN $0 ¢ 
115144 GEN 50 e 
114544 GIEN 804 
114444 GIEN 0+ 
114144 GIEN SO. 
113344 GIEN 06 
143144 GEN 0 ¢ 
113044 GEN 04 
L12144 GEN 80 « 


SUR TIRTVER - DX% 
SUB DRIVER ~ LPS 
SUR TIRIVER ~ MMt 
SUB DRIVER - TTS 12) 
MAIN TASK 
MAIN SYS 
MAIN SYS 
00002400 LBOt-00016770 FIXED 
00010000 1.BO?-00020165 
00040000 1.BOt-00021331 
00013500 LRO!-00021064 
00040000 I.BO!~00017367 
00010000 I.B0!~00020241 
00040000 1.80! -00020202 
00020000 I.B0!-00020400 
00024000 L.ROt-0001.7605 
00020000 L.ROt-00021444 
00010000 1.R0%-00020304 
00040000 1.B0?~00017657 
00040000 L.ROt-00021233 
00040000 1.B0?-00020265 
00040000 L.ROt~000205 
90001100 LBO!-00020147 
00040000 1.80-00021000 
00040000 L.RO?-00020001 
00040000 1.BO%-00020175 
00040000 1.ROt-00020105 
00040000 LROt~90020650 
00940000 LRO$-00020650 
00040000 1.BOt 00020323 
00040000 LRO?-00017451 
00040000 L.B0t-00021727 
00040000 LBO%-00021274 
00037000 LRO?-00021635 
00003700 L.ROt-00020310 
00040000 L.RO?-00020544 


TTLS 


TT22 
TT23 
TT24 
TT25 
TT26 
TT27 
TT3O 
TYTS1. 
TT32 
TT33 
TT34 
TT35 
TT36 
TT37 
TT40 
TT41 
TT42 
TT43 
TT44 
TT45 
TT46 
TIO? 
COOs 
CLO 
LEO? 
SYO% 


SO SO FO FE FH OO OF FO Oe $F OH HH HO 


PO 6 6H 00 OO Oo OF 44 Oe 


L.OATHED 
LOAN 
LOATEN 
LOATEN 
LOANET 
LOATET 
LOATEL 
LOATHET 
LOATH! 
LOATIED 
LOATEN 
L.OATET 
LOATED 
LOALEL 
LOATIETL 
LOATEN 
LOATE 
LOAKET! 
LOATH 
LOAE 
LOA 
LOATET 
LODE 
LOAtEN 
LOADED 
LOAET 
L.OATIED 
LOATEND 
LOATEN 
OAK I 
LOATED! 
LOANED 
LOATHEL 
LOATIEN 


TYOS 
TTOS 
NRO S 
TRO? 


UMFE 2. 


Mb “> "ae “> E> “ED OR E> > ES ED ae “Er > o> 


iM 
oN 


oR 


= 
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file 


yo times 
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exitses boot in your tarset 
and save the sustem with 2 


An alternate version af GYSLIE called ANSLIE has 


aon the RSXM26 disk. 


Lo 


take into accaurt ANST super 


Sineea vou have selected ANST mastare surrort wou 
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SYSGEN mounts the mapped source disk, establishes logical 
assignments, and issues a PIP command to display the amount 
of free disk space. 


This section creates the system libraries and uses’ the 
librarian (LBR) to replace modules with their ANSI 
equivalents. 


The old libraries are deleted and then SYSGEN invokes LBR-_ to 
create the Executive libraries. 


SYSGEN deletes the task build maps. 


SYSGEN creates a new symbol table (.STB) file (the baseline 
system STB file is no longer needed). 


This section builds the loadable drivers. Note that SYSGEN 
deletes unnecessary driver build command files after the task 
build completes and truncates the STB files. 


This section builds the privileged tasks. Note that SYSGEN 
builds the small version of the indirect command file 
processor. If you want to build the larger version of AT., 
you must do so manually. 


For mapped systems, build the 12K-word version from [1,24] 
(BIGINDBLD.CMD) to gain symbol table space. 


For unmapped systems, built the 14K-word version from [1,20] 
(BIGINDBLD.CMD) to gain symbol table space. 


SYSGEN swaps the logical assignments of the pseudo devices 
SY: and LBs: and issues a PIP command to display free disk 
space. 


Kit variance. For RLO1 and dual RKOS kit users, you must 
create the file RSX11M.SYS based on the example. For big 
Gisk kit users, SYSGEN creates this file. 


SYSGEN installs Boot and VMR and then establishes’ logical 
assignments for VMR. 


This is a VMR warning message only. The message results from 
the VMR command that contracts the driver partition (SET 
/TOP=DRVPAR:-*). 


The command file SYSVMR loads drivers, installs tasks and 
issues the following display commands: 


SET /POOL 
PAR 
TAS 
DEV 


VMR then prompts to allow users to issue further commands’ or 
to exit. 


At this point, the system generation process is complete. The RSXM26 
disk contains a tailored and bootable RSX-11M version 3.2 system 


image. 


The following console display confirms it. 
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SINS #800 
“MOU DLS REXM26 
“ROO Dili sS4] 


RSX-11M V3.2 BL26 S1i2k 


“RED DLs=Sy7s 

RED DLLs 

MOU TLIRSXM26 

BDL tli» 2ISTARTUP 

“.K FILEASE ENTER TIME ANTI! 
TIM 12300 6-JUN-79 
ENTER LINE WI0TH OF THI 
SET /BRUF=TIi132. 

ACS SY?/BLKS=S1e2+ 


poe gs 4s 
fae ws «2 ae a es ee ae ae 


+ 
~3 NOTE - The Raseline IND 
r) a rriority of 10. 
aoe] 
3 1e >REM eee AT. 
“e § > INS $BRIGING/PRI=1 
“e F 
‘@ <EOF 
TIM 9 \y 


12200325 06~-JUN-79 
~$1T SEEMS OK 

>TEV 

LEO: OFFLINE LOADED 
TRO? LOATED TYPE=RKFO6 
TRL: LOADED TYPE=RPO6 
pe2: LOADED TYFE=RFO4 
QRZ? LOADED TYPE=RFO4 
nko? LOADED 

KL? LOARED 

k2t LOADED 

WK3? LOADED 


MAFPFET! 


TATE CHRIMN DU-MMM-YY) cSii 12 


S TERMINAL CD Det 


irect must be rer 
for SYSGEN- 


0, 


100 6-JUN~79 


32,43 


laced by BIGINE with 


Of PUBLIC MOUNTED LOADED LABEL=RSXM26 TYPE=RLO1 


Lit LOADED TYPE=RLO1 
DMO? LOADED TYFE=RKOG 
YMit LOADEL TYPE=RKO06 
nso: LOADED TYFPE=RS04 
sit LOADED TYPE=KSO04 
uTO? LOATEL 

VTi? LOANED 

xo? LOANED 

UxXit LOAGeEn 

MMO? LOANED 

MMi? LOADED 

TTOt CrJ - LOGGED ON LOAL 
TT1: LOADED 

TT2? LOADED 

TT3? LOADED 

TT4:? LOADED 

TTS? LOADED 

TT63 LOADED 

TY7: LOATEDL 

TT103 LOADED 

TY11? LOADED 

TT123 LOATED 

TY132 LOADED 

TT14? LOADED 

TTi5! LOALED 

TT16¢ LOADED 

TT17: LOADED 


Et 
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TT203 LOADED 
TT213 LOADED 
TT22% LOADED 
TT23% LOADED 
TT243 LOADED 
TT253 LOADED 
TT263 LOADED 
TT27% LOADED 
TT3O3 LOADED 
TT313 LOADED 
TT323 LOADED 
TT33% LOADED 
TT343 LOADED 
TT353 LOADED 
TT363 LOADED 
TT373 LOADED 
TT403 LOADED 
TT413 LOADED 
TT42? LOADED 
TT433 LOADED 
TT443 LOADED 
TT453 LOADED 
TT46? LOADED 


TIO: 
COOs TTO3 
CLO$ TTO3 


LHO3 DLO? 
SYO3 TL.O3 

SPIP C19547%.%/PU 

MCR -- TASK NOT IN SYSTEM 

>INS $PIP 

>PIP C12547%.x/PU 

PIP -~- FAILED TO DELETE FILE 
DLOIC1*S4]B00.TSK$1 -- PRIVILEGE VIOLATION 
Pip -~ FAILED TO DELETE FILE 
DLO?L1,54I0M0.TSK#1 -- PRIVILEGE VIOLATION 
PIP -- FAILED TO DELETE FILE 
DLO?CirS4TIND.TSK#1 -- PRIVILEGE VIOLATION 
PIP -- FAILED TO DELETE FILE 
DLOIC1»S47INI-TSK#1 -- PRIVILEGE VIOLATION 
Pip -- FAILED TO DELETE FILE 
DLO?CArS47ING.TSKI1 —- PRIVILEGE VIOLATION 
PIp -~ FAILED TO DELETE FILE 
DLOIC1:S4ILOA.TSK#1 —~ PRIVILEGE 
PIr ~~ FAILED TO DELETE FILE 
DLO?C1»54IMOU.TSK$1 ~~ PRIVILEGE VIOLATION 
PIF -- FAILED TO DELETE FILE 
DLOSCL+S4ISAV.TSKS1 ~- PRIVILEGE 
MCR>ABO PIP 


F 
TASK “ss ePIF" TERMINATED 
ABORTED VIA DIRECTIVE OR MCR 


AND WITH FENDING 10 REQUESTS 


VIOLATION 


VIOLATION 


>$FORGOT TO CHANGE UICr CAN‘’T DELETE FILES 


“SET /UIC#C1254] 
PIP C19547K-*/PU 
>PIF /FR 


BLOCKS FREE, 8998. BLOCKS USED OUT OF 10240. 


ILO? HAS 1242. 
a BLOCKS 


LARGEST CONTIGUOUS SPACE = 519. 


*REM FIP 


CHAPTER 8 


VMR COMMANDS 


The Virtual Monitor Console Routine (VMR) is an RSX-11M system program 
that allows complete configuration of an RSX-11M system image file for 
booting. As its name suggests, VMR provides the capability to execute 
Monitor Console Routine (MCR) commands that are directed to the disk 
image of a system. 

VMR supports a compatible subset of the MCR commands described in the 
RSX-LIM/M-PLUS MCR Operations Manual. All VMR commands have the same 


syntax and semantics as their MCR counterparts with the one exception 
of the SAVE command. 


8.1 STARTING VMR 
You can start VMR four ways. The first three methods apply when you 
have installed VMR and it is ready to be executed. The fourth method 
installs VMR automatically, executes it, and then removes it on exit. 
Method 1: 

>VMR @indirect 


The system loads VMR and executes the specified indirect command 
file; VMR then exits. 


Method 2: 
>VMR 
The system loads VMR, and VMR responds with the following prompt: 
ENTER FILENAME: 
Method 3: 
>RUN VMR 
The system loads VMR, and VMR responds with the following prompt: 
ENTER FILENAME: 
Method 4: 
>RUN S$VMR 
The system installs VMR from the pseudo device LB: under the 
system UIC (normally, [1,50] or [1,54}]) and loads it; VMR then 
responds with the following prompt: 


ENTER FILENAME: 
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In all starting methods except method 1, VMR prompts with: 


ENTER FILENAME: 


At this point, you specify the file that contains the image of the 
RSX-11M system you want to modify. VMR expects to find a symbol table 
file of the same name as the system image file, but with a file 
extension of .STB, on the same device and under the same UFD as the 
system image file (except when you use the /IM_ switch; see Section 
862).. For example, suppose you enter the following file specifier in 
response to the prompt: 


RSX11S.SYS 


A corresponding file, RSX11S.STB, must exist that contains the symbol 
definitions for the RSX11S.SYS system image. Note that the pseudo 
devices LB: and SY: on the running system must refer to the disk 
containing the system image file. 


The system image and symbol table files are in the standard format 
produced by the RSX-11M Task Builder. 


Upon receiving a valid file specifier, VMR opens and reads the symbol 
table file; it also opens the system image file and verifies that the 
file is actually a system image. VMR then prompts with 


VMR> 
You can now enter any valid VMR command or end VMR by typing CTRL/z.1 


If you used method 1 to start VMR, the specified file contains a 
series of commands to be executed by VMR. The first record in the 
file must contain a file specifier for the system image file that is 
to be modified. 


In addition to specifying an indirect file to start VMR, you can also 
enter the following any time that VMR prompts for input: 


@filespecifier 
This directs VMR to extract input from the specified file until it 
reaches an end-of-file and to return to the terminal for further 
input. This feature of VMR is useful when you want to repeat a series 


of commands for several generated systems (INSTALL commands, for 
example). 


8.2 VMR FILE SPECIFIERS 
File specifiers accepted by VMR are in the standard RSX-11M format: 


dev: [g,m]filename.type;ver[/IM] 


1 CTRL/Z is typed by simultaneously depressing the CTRL and Z keys. 
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Parameters 


dev: 


The device unit on which the volume containing the desired file 
is mounted (for example, DKO or DT1). The name consists of 2 
ASCII characters, followed by an optional 1l- or 2-digit octal 
unit number. The default device is SYO. 


[g,m] 


The User File Directory (UFD), consisting of a group number and a 
member number. The default is the UFD that corresponds to the 
UIC under which VMR is running. 


filename 


The name of the file. An RSX-11M file name can be up to 9 
alphanumeric characters long. The file name and file type are 
always separated by a period (.). You must specify a file name; 
no default is applied. 


typ 
The file type, consisting of up to 3 alphanumeric’ characters. 
The defaults are SYS for system image files and CMD for indirect 
command files. 

ver 
The version number in the range of 0 through 77777(8). The 
default is the highest version, 

/IM 


A switch option that, when attached to the system image file 
specification and used with the SAVE command, overrides the VMR 
requirement for the symbol table file. 


This is the only switch provided with VMR. You use it to write 
non-RSX-11M system images to secondary media in bootstrappable 
format. 


When you use the IM switch with the file specification, the only 
command VMR will accept is the SAVE command. This switch is 
useful when you use an RSX-11M system as a host system to develop 
and create small, main memory resident systems that must be 
loaded from a serial medium (Such aS paper tape). 


8.3 COMMAND SYNTAX 


You do not have to type an entire command name to VMR. VMR accepts 
the first three characters of a command and then searches for a blank 
or tab followed by the command parameters or by a carriage return if 
there are no parameters. Because a blank or a tab is required before 
parameters, VMR does not allow embedded blanks in a command name. If 
you enter a command incorrectly, VMR displays an error message at your 
terminal. 
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The following example illustrates the TIME command. Note that the 
square brackets in the example indicate that the "E" is optional: 


VMR>TIM[E] <CR> 
14:00:04 21-MAY-79 


8.3.1 Keywords 


Some commands use keywords that generally apply to a command argument. 
A keyword consists of a Slash (/), followed by an ASCII 
identification, and optionally followed by an equal sign (=) and_ the 
value of the keyword, as follows: 


/keyword=value 


You can enter keywords in any order. As an example of keyword usage, 
the INSTALL command requires a file name argument specifying the task 
to be installed. You can append keywords to the file name. One such 
keyword, /TASK, specifies the name under which the task is to be 
installed. 


VMR>INS BOB.TSK/TASK=AMBER 


This command causes the task contained in the file named BOB.TSK to be 
installed with a name of AMBER. Keywords are command specific and are 
defined with each command. 


8.3.2 Comments 


VMR treats a line of text as a comment if the first character in the 
line is a semicolon (;). In addition, you can use the exclamation 
Mark (!) to delimit comments in a command. The first exclamation mark 
starts the comment and the next exclamation mark or end of line 
terminates the comment. VMR ignores all text between the two 
exclamation marks. For example: 


VMR>; THIS LINE IS A COMMENT 
VMR>TAS !THIS IS A COMMENT STRING! 
Comments are especially useful to clarify commands in VMR_ indirect 


command files. (Refer to the RSX-11M/M-PLUS MCR Operations Manual for 


further information about indirect command files.) 


8.4 COMMAND SUMMARY 

The VMR commands described in this chapter are listed below by 
category. This command summary provides a compact overview of the 
facilities available through VMR. The detailed descriptions of the 
VMR commands given in Section 8.5 are presented in alphabetical order. 


Initialization Commands 


ASSIGN Define or delete a global logical device assignment. 
List current assignments on console terminal. 


INSTALL Install a task into the system image. 
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LOAD Load a device driver. 

REDIRECT Redirect all I/O requests from one physical device to 
another. 

SAVE Write the system image of memory onto a_e secondary 
media in bootstrappable format. 

SET Set system and terminal characteristics; define 
partitions; display terminal and partition 


characteristics on entering terminal. 


TIME Enter time and/or date into the system image; display 
the time and date on entering terminal. 


UNLOAD Unload a device driver. 


Informational Commands 


DEVICES Display on the entering terminal a list of peripheral 
devices defined in the system image. 


LUNS Display on the entering terminal the list of LUN 
assignments for an indicated task. 


PARTITIONS Display on the entering terminal the list of 
partitions defined in the system image. 


TASKLIST Display on the entering terminal a list of all tasks 
installed in the system image. 


Task Control Commands 


ALTER Alter the priority of a task. 

CANCEL Cancel the time-based initiation requests for a task. 

FIX Fix a task in system image. 

REASSIGN Change a task's LUN assignment. 

REMOVE Remove a task from the system image. 

RUN Schedule a task's activation. The task may run after 
one clock tick, after a delay, or in synchronization 
with the system clock. Periodic rescheduling is 


optional. 


UNFIX Unfix a task from the system image. 


8.5 VMR COMMAND DESCRIPTIONS 


The following subheadings are used in the detailed command 
descriptions in this’ section. Subheadings that do not apply to a 
particular command are omitted from the command description. 
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COMMAND NAME 
This subheading consists of the command name in capital letters. The 


minimal VMR command acronym is shown on the right margin. The text 
following the name describes the command's function. 


Format 

The command format is given, and all parameters are described. 
Parameters 

Parameters are listed and described. 
Examples 

Examples of using the command are shown. 


Notes 


A list of special considerations that may assist you in using the 
command properly appears under this subheading. 


ALTER 


Use the ALTER command to change the static priority of an 


task. 


Format 
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ALT[ER] taskname /PRI=priority 


Paramete 
taskname 
The 
/PRI 
The 
priority 


The 
250 


Example 


rs 


name of the task whose priority 


is to be altered. 


keyword that changes the task's static priority. 


new priority to be assigned to the specified task, 


(decimal). 


>ALT TEST /PRI=248. 


Alter the static priority of task TEST TO 248(10). 


ALT 


installed 


from 1 


to 
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ASN 


ASSIGN 


Use the ASSIGN command to define, delete, or display logical-device 
assignments. Logical-device assignments are a way to associate 
logical names with physical devices, pseudo devices, or other logical 
devices. When you assign a logical name to a pseudo or logical 
device, the system resolves the assignment to the associated physical 
device. There are three types of logical-device assignment: global, 
local, and login. VMR supports the manipulation of global assignments 
only. See the RSX-11M/M-PLUS MCR Operations Manual for additional 


information on local and login assignments. 


The manipulation of global assignments applies to all tasks in the 
running system. 


A logical-device name has the same syntax as a physical device unit. 
It consists of a 2-character ASCII name (alphabetic) and an optional 
l- or 2-digit octal unit number, followed by a colon (:). The 
2-character name can either be equivalent to a standard RSX-11M device 


name (for example, DK:) or two letters picked at random (for example, 
KY2)-« 


When you install a task, or the system executes an ASSIGN LUN 
directive, the system scans the logical device table before it scans 
the physical device table when it searches for a specified device. As 
a result, you can define logical device names that are identical to 
physical device names even though the logical and physical device 
names do not refer to the same physical device. The system resolves a 
specified device name to the first matching table entry found. If a 
logical device name is identical to a physical device name, the 
logical name has precedence. 

Formats 

ASN ppnn:=llnn:/GBL 


Define a global assignment that associates the logical name llnn; 
with device ppnn:. 


ASN /GBL 
Display all global assignments for the system. 
ASN =[llnn:]/GBL 


Delete the specified global logical-device assignment or all 
global assignments if the command omits llnn:. 


Parameters 
PP 


A physical, logical, or pseudo device name. 


nn 
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A unit number. 


ll 


A logical device name. 


Examples 


VMR>ASN 


VMR>ASN 
GBO: 


VMR>ASN 


DK: =GB0:/GBL 


/GBL 
DKO: GLOBAL 


=/GBL 


!Define global logical device 
!name 


!List all assignments 


!Delete all global assignments 
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CAN 


CANCEL 
Use the CANCEL command to cancel time-based initiation requests for a 
task. These requests result from the RUNS directive or any of the 
time-synchronized variations of the VMR RUN command. 
CANCEL does not affect the execution of the task that may be active in 
the saved system image. It removes’ only the time-based schedule 
requests still in the clock queue. 
Format 

CAN[CEL] taskname 
Parameter 


taskname 


The name of the task whose time-base initiation request is to be 
canceled. 


Example 
VMR>CAN XKE 


Cancel all periodic rescheduling and time-based initiation 
requests for task XKE. 
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DEV 


DEVICES 
Use the DEVICES command to display on the entering terminal the 
symbolic names of all device-units or, optionally, all of a particular 
device type defined in the system image. The device names appear in a 
single vertical column. A second column contains any additional 
information about each device. 
Formats 

DEV [ICES] 

DEV[ICES] dd: 
Parameter 


dd: 


The particular device type to be displayed. 


Examples 
VMR> DEV 
DBO: LOADED 
DB1l: LOADED 
DB2: LOADED 
DB3: OFFLINE LOADED 
DKO: LOADED 
DK1; LOADED 
DK2: LOADED 
DSO: 
DS1l: 
DTO: LOADED 
DTl: LOADED 
LPO: LOADED 
MMO: LOADED 
MM1: LOADED 
PPO: UNLOADED 
PRO: UNLOADED 
TTO: 
TTl: 
TT2: 
TT3: 
TT4: 
Coo: TTO: 
CLO: LPO: 
SY03: DBO: 
LBO: DBO: 
VMR>DEV DK: 
DKO: LOADED 
DK1l: 
DK 2:3 


The following list describes the messages that can appear in the 
second column. More than one message can appear on the same line. 
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OFFLINE indicates that, although the system tables contain 
entries for this device, the system as saved did not contain 
the related device. 


LOADED indicates that the driver for the device is loadable 
and is currently loaded. 


UNLOADED indicates that the driver for the device is loadable 
and is currently not loaded. 


A device name in the second column is the device to which’ the 
corresponding device in the first column has been redirected. 


Absence of either LOADED or UNLOADED in the second column 
indicates that the driver is permanently resident; it is 
linked to a part of the Executive. 
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FIX 


FIX-- IN-MEMORY 
Use the FIX-IN-MEMORY command to load a task into its partition in the 
system image. The system can service requests for running the task 
more quickly because the task is memory-resident and does not have’ to 
be loaded from the disk before it can run. VMR can fix a task in the 
system image only if the partition in which it is to be fixed is 
available. On RSX-11S systems, all installed tasks must be fixed 
since they cannot be loaded into the running RSX-11S system. 
Fixed tasks remain in memory even after they exit. Therefore, they do 
not have to be reloaded when a request is made to run them. (Note 
that re-executing fixed tasks is not always practical.) Only an UNFIX 
or REMOVE command can free the occupied partition. 
The following restrictions apply to the fixing of tasks: 

e Checkpointable tasks cannot be fixed, 

e Active tasks cannot be fixed, 

e A task must be installed before it can be fixed, 


e A task can only be fixed in a task partition, and not in 
system-controlled partitions. 


Format 
FIX taskname 
Parameter 
taskname 
The task that you wish to fix in memory. 
Example 
VMR>FIX XKE 


Fix task XKE in its partition. 
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INS 


INSTALL 


Use the INSTALL command to make a specified task known in the system 
image, or to load a common into a common partition. An installed task 
is dormant until the Executive receives a request for it to run. The 
optional keywords either provide parameters that were not specified at 
task build or override parameters that were. 


When a task is installed, VMR creates a Task Control Block (TCB) _ for 
the task in a system image table called the System Task Directory 
(STD). The task parameters contained in the TCB enable the system to 
run the task when requested to do so by an MCR command, VMR command, 
or a system directive. A task cannot be run until you install it. 


A task's TCB contains the address of the load-device Unit Control 
Block (UCB) and the Logical Block Number (LBN) of the task image file. 
The Executive can therefore load the task image in one transfer when 
an MCR command or system directive requests an installed task. 
(Loading requires more than one transfer if the task is greater than 
32K words.) 


When VMR installs a task in a virgin system, it stores the task's 
logical block numbers in the task header. When you save a system, the 
SAVE command places the file identification, rather than the file's 
LBN, in the TCB. Then, when the system is rebooted, it reopens the 
task file and stores the task's new LBN in its TCB. If a task has 
been deleted, the system cannot open the task file when the system is 
rebooted. The system then automatically removes the task's TCB’ from 
the STD. When VMR installs a task in a saved system image, it stores 
the task's file identification, rather than the LBN, in the TCB_ to 
allow a reboot to occur successfully. 


Also a saved system does not retain the physical addresses of 
installed tasks. The Disk Save and Compress (DSC) utility can 
compress and copy a disk containing a saved system, thus moving the 
task files to different physical locations. But because the TCB 


‘entries contain task file identifications, rather than LBNs, after a 


system save, the system can function normally when it is rebooted. 
Format 
INS[TALL] filespec[/keyword] [/keyword]... 
Parameters 
filespec 
A task image file specifier in the form: 
dev: [group,member]filename.type; version 


The type defaults to TSK. Standard defaults apply to the 
remaining fields. 
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_keyword 
One of the keywords listed below: 


/CKP=option 


/INC=size 

/PAR=pname /SLV=option 
/PMD=option /TASK=taskname 
/PRI=number /UIC=[group,member] 


/PRO=[system,owner,group,world] 
Keywords 
/CKP=option 


The option is yes or no. If CKP=YES (default for checkpointable 
tasks), checkpointing is enabled for the task. If CKP=NO, 
checkpointing is disabled for the task. 


The /CKP keyword overrides the /CP switch specified at task 
build. 


On systems that support the dynamic allocation of checkpoint 
space, the task image file does not need to contain allocated 
checkpoint space. The presence of the /CKP=YES keyword instructs 
the system to allocate checkpoint space for the task when 
required from a checkpoint file. 


/INC=size 


The size is the number of additional words of address space to be 
allocated to a task. The extension size is usually expressed in 
octal but may also be expressed in decimal by appending a period. 
This keyword overrides the Task Builder's EXTTSK or PAR option 
keyword. Tasks such as MACRO-11, TKB, PIP, VFY, and AT. use the 
space from the end of the task image to the end of their address 
Space aS dynamic memory in which to allocate symbol tables. and 
buffers. The INC keyword defines the number of words in this 
dynamic region. The default size is the size specified at 
task-build time, or, if none specified at task build, zero. 


/PAR=pname 


A partition name that overrides the partition specified at 
task-build time. 


If the keyword specifies a nonexistent partition, VMR issues a 
warning message and attempts to install the task in the GEN 
partition. 


Default: TKB uses the name GEN, 
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/PMD=option 


The option is yes or no. If PMD=YES, the system will perform a mm 
post-mortem dump of the task if it aborts the task because of an 

SST error condition. If PMD=NO (the default from a_ task-build), 

the system will not perform a dump at SST abort time. 


To generate a dump, you must install the post-morem dump task 
PMD... in the system. 


This keyword overrides the Task Builder's /PM switch. The 
default is specified at task-build time. 


/PRI=number . 


The number is the priority at which the task is to be installed. 
The value range is 1 through 250(10). Standard RSX-11M number 
conventions apply to this parameter. The default is PRI=50. 


/PRO=[system,owner,group,world] 


The PRO keyword establishes a protection mask for a common. The y 
user groups are defined as: 7 


e System - All system tasks running under a UIC group’ number 
less than or equal to 10(8). 


e Owner - Tasks that run under the same UIC as the files owner. 

e Group - Any task that is running under the same UIC group as 
the file's owner. 

e World = Any task that does not fit in one of the above ~~ 
categories. - 


The PRO keyword establishes the access rights for each group. 
The four types of access are: 


e Read 
e Write 


e Extend 


e Delete 
For example: 
INS COM/PRO[RWED,RWED,R,R] 


gives read, write, extend, and delete access to the system and 
owner and read access to the group and world. 


/SLV=option 


The option is yes or no. If the command specifies /SLV=YES, data 
sent to the installed task is marked with the TI: of the sending 
task. When the installed task receives the data, the system sets 
the task's TI: to that associated with the data. This keyword 
overrides the Task Builder's /SL switch. 


If the command specifies /SLV=NO, the TI: of the task does not 


change when receiving data. The default is specified at task a=, 
build. aa 
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/TASK=taskname 


The name to be used to install the task. The default is the name 
specified at task-build time or the first 6 characters of the 
file name. 


/UIC=[group,member ] 


The square brackets are required syntax. This UIC is the default 
for the task. You can override it with the RUN command. The 
task YIC determines the file-protection class (system, owner, 
group, world) in which a task belongs, and thus directly 
influences file access. Note that file protection may differ 
from file to file. 


The default is from the task build. This default applies only to 
tasks started by a RUNS directive or a RUN command that specifies 
a time delay before runtime. Tasks started by typing the name as 
a command (for example, PIP and TKB) run under the default UIC of 
the terminal from which the command was issued. 
Examples 

VMR>INSTALL SCAN 
Install task SCAN using the default priority and UIC. 

VMR>INSTALL DK1: [1,111] SCAN.TSK;4/PRI=103 


Install task SCAN, file type TSK, version 4 from device DKl:, 
group number 1, member number 111, with a priority of 103(8). 


VMR>INS MAC/INC=4096./PAR=SYSCTL 


Install task MAC in the partition SYSCTL and increase the task 
size by 4096 decimal words. 
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LOA 


LOAD 
Use the LOAD command to load a nonresident device driver into the 
system image. The LOAD command constructs the data base and interrupt 
vector linkages required to allow access to the device. This command 
eliminates the need to link infrequently used device drivers 
permanently into the Executive. (Executive support of loadable device 
drivers is a system generation option.) 
Format 
LOA[{D] dd: [/keyword=value] [/keyword] [/keyword]... 
Parameters 
dd: 
A 2-character ASCII device name. 
keyword 
One of the following three- or four-letter keywords: 
/ PAR=pname 
/SIZE=psize 
Keywords 
/PAR=pname 
The pname is a partition name. The PAR keyword is used to name 
the partition into which the driver is to be loaded. It 
overrides the partition specified at task build time. 
/SIZE=psize 
The psize is partition size. The SIZE keyword is used to 
establish the minimum size (octal words) of the partition into 
which the driver is to be loaded. VMR rounds psize up to the 
next largest unit of 100 octal. Psize must be less then 77741. 
Examples 


VMR>LOAD MM: !LOAD TU16 DRIVER (MMDRV) 


VMR>LOA LS:/PAR=DRVPAR !LOAD LPS11 DRIVER (LSDRV) INTO 
!DRVPAR 


Notes 


1. Guidelines for building loadable device-driver tasks are 
rigidly defined. These guidelines are described in the 
RSX-11M Guide to Writin an I/O Driver. The system 
generation procedures include provisions to simplify the task 
building of drivers. 
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The LOAD command requires that a driver's TSK and STB files 
reside under the same UFD and on the same disk as the system 
image upon which you are working. For example, the following 
command requires that the files DTDRV.TSK and DTDRV.STB 
reside on SY: under the current UIC. 


LOA DT: 
The LOAD command requires pool space as follows: 
a. If the driver data base is being loaded, the command 
needs pool space equal in size to the size of the data 


base. 


b. The command needs pool space for an Interrupt Control 
Block (ICB) for each interrupt entry point in the driver. 


c. The command needs pool space for a Partition Control 
Block (PCB). 
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LUN 


LOGICAL UNIT NUMBERS 


Use the LUN command to display at the entering terminal the static LUN 
assignments for a specified task. (Static assignments are those 
recorded in the task's disk-image file.) The display consists of a 
list of physical device units in one column, with the corresponding 
LUNS in an adjoining column. 


Format 
LUN[S] taskname 
Parameter . 
taskname 
The task for which the LUNs are to be displayed. 
Example 
VMR>LUN XKE 
SYO: 
SYO: 
CLO: 
TT3: 
TTS: 


DKO: 
TT3: 


NOU DB WN 


The display shows static assignments for LUNS 1 through 7 as 
recorded in the task-image file header; no other LUNS are 
Statically assigned to the task XKE. 
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PAR 


PARTITION DEFINITIONS 


Use the PAR command to display on the entering terminal a 
of each memory partition in the system image. 
six columns that specify: 


description 
The display consists of 


l. Partition name 
2. Partition Control Block address (octal) 
3. Partition base address (octal) 
4. Partition size (octal) 
5. The partition type and, following the partition type, the 
partition occupant(s) -- task, driver, common, etc., 
6. The name of partition occupant(s). 
Format 
PAR[TITIONS] 
Example 
Name PCB Base Size PAR/TASK Name 
VMR> PAR 
TTPAR 117734 00120000 00040000 MAIN TASK 
SYSPAR 117670 00160000 00010000 MAIN TASK 
TKNPAR 117624 00170000 00010000 MAIN TASK 
DRVPAR 117560 00200000 00027700 MAIN SYS 
117340 00200000 00002000 SUB DRIVER — DB: 
117240 00202000 00001100 SUB DRIVER - DK: 
117140 00203100 00002500 SUB DRIVER - DM: 
117040 00205600 00002300 SUB DRIVER - DR: 
116740 00210100 00001000 SUB DRIVER - DS: 
116640 00211100 00001100 SUB DRIVER ~ DT: 
116540 00212200 00001400 SUB DRIVER - DX: 
116440 00213600 00002100 SUB DRIVER - DL: 
116340 00215700 00001300 SUB DRIVER - LP: 
116204 00217200 00003700 SUB DRIVER - MM: 
115550 00223100 00003000 SUB DRIVER -— CO: 
LDRPAR 117514 00227700 00002400 MAIN TASK 
BASIC2 117450 00232300 00040000 MAIN COM 
GEN 117404 00272300 00175000 MAIN SYS 
060400 00272300 00040000 SUB (..-SAV) 
VMR> 
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REA 


REASSIGN 
Use the REASSIGN command to reassign a task's Logical Unit Numbers 
(LUNS) from one physical device unit to another. The reassignments 
affect only the static assignments recorded in the task's disk image 
file. 
The command does not affect a memory-resident' task. Therefore, 
REASSIGN has no effect on the assignments for a task that is fixed or 
loaded in memory. 
Format 

REA[SSIGN] taskname lun nud: 
Parameters 
taskname 

The name of the task for which the LUNS are to be reassigned. 


lun 


The logical unit number. 


nud 
The new device unit, which can be a physical, logical, or pseudo 
device. 

Examples 


VMR>REA JOE 3 TTO: 

Reassign LUN 3 of task JOE to device TTO:. 
VMR>REA BILL 2 TTl: 

Reassign LUN 2 of task BILL to device TTl: 
VMR>REA TEST 3 XX: 


Reassign LUN 3 of task TEST to logical device XX:. 
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RED 


REDIRECT 


Use the REDIRECT command to redirect all I/O requests from one 
physical device-unit to another physical device-unit. 


Note that an attached device and the device TI: cannot be redirected. 
In addition, one pseudo device cannot be redirected to another pseudo 
device. 
Format 

RED[IRECT] nud:=old: 
Parameters 
nud; 

The new device unit to which requests will be redirected. 
old: 

The old device unit from which requests have been directed. 
Examples 

VMR>RED TT3:=TT6; 
Redirect all I/O requests for device TT6: to device TT3:. 


VMR>RED TT:=LP: 


Redirect all I/O requests for device LPO: to device TTO:. 
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REM 


REMOVE 


Use the REMOVE command to delete a task or region name from the system 
image. Removing a task from the system image makes the task unknown 
to the system. The action resulting from this command is the 
complement of INSTALL. 


The REMOVE command cannot remove an active task from a saved _ system. 


An example of such a task is the SAVE task; an attempt to remove SAVE 


from a saved system results in an error. The message TASK ACTIVE is 
displayed. 


Formats 
REM[OVE] name 
Parameter 
name 
The name of the task to be removed. 
Example 
VMR>REM SCAN 
Remove the task named SCAN from the system image. The task-image 
file remains unaffected. Note that tasks installed as ...XXX can 
be removed by 
>REM XXX 
or 
>REM ..«XXX 
Notes 
1. If a task that is the object of a REMOVE command is’ fixed, 
the command automatically unfixes the task from the system 


image. 


2. REMOVE automatically cancels all time-based schedule requests 
for the specified task. 


3. You cannot remove a task if it has send or send-by-reference 
packets queued to it. 
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RUN 


RUN 


Use the RUN command to initiate the execution of a task. The command, 
which has four formats, can cause a task to be: 


e Started one clock tick after system boot 
e Started at a time increment from the system image time 
e Started at a time increment from clock unit synchronization 
e Started at an absolute time of day 
All of these options are available with or without rescheduling. 
Format 1 
Run one clock tick after system boot 
RUN taskname [/RSI=magu] [/UIC=[uic] ] 
Parameters 
taskname 


A l- to 6-character taskname of the task that you wish the system 


to run. 

RSI 
The reschedule interval. The format is the same as for dtime, 
which is detailed below under format 2. The reschedule interval 
specifies how often you want the system to rerun the task. Each 
time the interval of time you have specified lapses, the system 
will make an initiation request for the task. The default is no 
rescheduling. 

UIC 
The UIC that has the format [g,m] where g and m_ represent’ the 
group and member numbers respectively. Legal group and member 
numbers range from 1 through 377(8). The square brackets are 
required syntax. This is the UIC under which the task is 
requested. It determines which files the task may access. The 
default is the value established for terminal CO:. 

Format 2 
Run at a time increment from the system image time 
RUN taskname dtime [/RSI=magu] [/UIC=[uic] ] 

Parameters 

taskname 


A l- to 6-character taskname. 


dtime 


VMR COMMANDS 


The time at which the task is initiated in time units’ from 
current system image time. It has the form: 


magu 


mag 


The magnitude 


Time units specified as follows: 


T 


M 


H 


for ticks. A tick is a clock interrupt, and the rate at 
which interrupts occur depends on the type of clock 
installed in the system. 


For a line frequency clock, the tick rate is either 50 or 
60 ticks per second, corresponding to the line frequency. 


For a programmable clock, a maximum of 1000 ticks’ per 
second is available. (The frequency is selected at system 
generation.) 
for seconds. 


for minutes. 


for hours. 


The magnitude is the number of units to be clocked, but’ the 
magnitude value cannot exceed 24 hours in specified units. 


RSI 


Units 


Units 


T. Any Positive value is valid (maximum of 15 
bits). 


Units = S. Any Positive value is valid (maximum of 15 


bits). 


7] 
= 


The maximum magnitude is 1440(10). 


Units = H. The maximum magnitude is 24(10). 


See format 1, above. 


UIC 


See format 1, above. 


Format 3 


Run at a time increment from clock unit synchronization 


The task start-time is determined by computing the number of 


ticks 


until the next time unit's occurrence (hour, minute, 


second, tick) and then adding on the number of ticks for the 
specified time increment to elapse. 


RUN taskname sync [dtime] [/RSI=magu] [/UIC=[uic]] 
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Parameters 
taskname 


A 1l- to 6-character taskname. 


syne 
H = synchronize on the next hour 
M = synchronize on the next minute 
S = synchronize on the next second 
T = synchronize on the next tick 
dtime 
Defined in format 2, above; dtime, if present, is added to the 
synchronization unit to produce the actual run time for running 
the task. 
RSI 
See format 1, above. 
UIC 
See format 1, above. 
Format 4 
run at an absolute time of day 
RUN taskname atime [{/RSI=magu] [/UIC=[uic] ] 
Parameters 
taskname 
A 1l- to 6-character taskname. 
atime 
The absolute time of day when this task will be initiated. Input 
format is hh:mm:ss. 
hh = hours (decimal assumed) 
mm = minutes (decimal assumed), and 
SS = seconds (decimal assumed). 
RSI 
See format 1, above. 
UIC 
See format 1, above. 
Examples 


>RUN XKE 15M 


Run task XKE 15 minutes from the current system image time. 


Note 


VMR COMMANDS 


>RUN XKE 15M/RSI=90S/UIC=[3,1] 


Run task XKE 15 minutes from the current system image time, 
rescheduling it every 90 seconds, with a UIC of [3,1]. 


The correct value to be inserted in the clock for forms 2 through 
4 is computed from the current value of the system time stored in 
the system image. Thus, the system image time must be set before 
any RUN requestS are made or they may not occur at the correct 
time after the system is booted. 
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SAV 


SAVE 


Use the VMR SAVE command to write the image of a system onto a 
sequential medium in bootstrappable format. With this command you can 
copy an RSX-11S or a foreign system onto a tape or a floppy disk. You 
can then transport the tape or floppy to another computer and 
bootstrap it, using a hardware bootstrap or the /BO switch in PRESRV 
(refer to the description of the /IM switch in Section 8.2 of this 
chapter). 


System images created with the SAVE command on all media, except paper 
tape, are in a format compatible with the logical tape format in 
PRESRV. Thus, any of PRESRV'S logical tape operations can be 
performed on system images created with the SAVE command. System 
images created by the SAVE command always start at the beginning of 
the medium. 


On paper tape, system images are created in absolute loader format and 
must be bootstrapped with the absolute loader. 


Format 

SAV[E] ddnn: [label] 
Parameters 
ddnn: 


The device-unit onto which the system image is to be written. 
Valid devices are as follows. 


CT: Tape cassette 

DD: DECtape II 

DT: DECtape 

DX: Flexible diskette 
DY: RX02 floppy disk 

MM: TE/TU16/TU45 magtape 
MS: TS04 magtape 

MT: TE/TU10/TSO3 magtape 
PP: Paper tape. 


label 
The file label name that must be specified for all secondary 
media except paper tape. It consists of from one to twelve 
alphanumeric characters. 
Examples: 
VMR>SAV MT:MYSYS 
In this example, the system image is written onto MT: in 


bootstrappable format. System changes, made by other VMR 
commands, are also saved with the system image. 


Notes 
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When you use the /LI command in PRESRV to list the contents 
of a medium (other than paper tape) that contains one or more 
system images created with the SAVE command, each system 
image causes a line to be printed which contains’ the 
following: 


a. VW (for VMR), indicated as the source device 
b. The label specified in the SAV command line 
c. A block size of 512 


d. The number of 512-byte blocks in the system image 
(excluding boot and label blocks) 


e. The date and time that the system was saved 


When you save RSX-11S systems on paper tape and you do not 
apply the /IM switch to the system's file name, the last 
1000(8) bytes of the system image are not written out. This 
allows space to accommodate the absolute loader. When you 
specify the /IM switch with the system's file name, _ the 
entire system image is written out to paper tape. In this 
case, it is your responsibility to ensure that the system 
image is not so large that it overlays the Absolute Loader. 


When saving a system on paper tape, contiguous blocks” that 
contain zero only and that begin on a 32-word address are 
compressed into a 2-word descriptor. This compression 
Significantly reduces both the amount of paper tape required 
and the time expended to create the tape and to read it into 
memory. After the entire image has been loaded into memory, 
a Short routine zeroes the appropriate blocks of memory 
before passing control to the bootstrapped system. 


When bootstrapping systems on media other than paper tape, 
regardless of the size of the system image, the last 1000(8) 
bytes of physical memory are not copied to accommodate’ the 
bootstrap. 


Systems saved on a TE/TU10/TS03, 9-track magtape drive can be 
booted from a TE/TU16 drive, and vice-versa, but not on a 
TSO04. 


When you specify the /IM switch with the system file 
specifier, the SAVE command always uses a bootstrap that does 
not enable memory management. 


The maximum memory size of a mapped system is 124K words. 
The SAVE command imposes maximum sizes on saved images in 
mapped systems for certain devices. If a mapped system is 
saved, and its memory size is greater than the maximum size 
imposed by the SAVE command for the specified device, only 
the amount of memory equal to the maximum size (Starting at 
physical location 0) is saved; no diagnostic message is 
issued. The devices for which the SAVE command imposes a 
maximum size on saved system images are: 


a. Paper tape punch (PP) - 28K words 


b. Flexible disk (DX) - 123K words 
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c. Flexible disk (DY) in single density - 123K words 


d. Cassette tape (CT) - 28K words 


None of the bootstraps require that the target RSX-11S system 
have a driver for the bootstrap device. 


The MM: drives are forced to 800 b.p.i. before writing to 
the tape. 
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SET 


SET 


You can use the SET command to alter a number of system-wide 
characteristics. The following list describes all the available 
options. The text in parentheses specifies keywords associated with 
the options. The SET command allows you to: 


e Display the status (determined by the keyword specified) for 
all terminals. 


e Establish device characteristics for any device in the system 
(BUF, CRT, ESCSEQ, LA30S, LOWER, REMOTE, SPEED...,). 


e Establish the default UIC for any terminal in the _ system 
(UIC). 


e Establish the system UIC used by the LOAD command and_ the 
Install-Run-Remove option of the RUN command. 


@e Set the status of any terminal in the system (PRIV or SLAVE). 
e Create partitions 

e Add space to the system dynamic memory (POOL). 

e Enable write check on devices that support it (WCHK). 


Improper use of the SET command can result in a situation in which the 
system will not accept privileged operator input. The following two 
situations should be avoided: 


e The system does not have any non-Slave, privileged terminals. 
Non-privileged terminals cannot enter privileged commands. 
Slaved terminals cannot enter unsolicited input to MCR, See 
the description of the /SLAVE keyword below. 


e The buffer length of all non-slave, privileged terminals is 
Shorter than 14 bytes. In this case, the terminal buffer is 
too short to enter many important commands required to 
continue system operation or alter the status of other 
terminals. See the description of the /BUF keyword below. 


A number of SET command options (CRT, ESCSEQ, LOWER, and WCHK) require 
Executive features that must be included at system generation. If you 
specify an option which has not been generated into the system image, 
the SET command has no effect and results in an error. 


VMR permits only one keyword per command. You can prefix most 
keywords by NO to negate or disable the function of the keyword. 
Exceptions are BUF, HFILL, LINES, TERM, POOLSIZE, POOL, SPEED, UIC, 


and SYSUIC; VMR returns a syntax error when NO precedes one of these 
keywords. 


1 
Format 


SET /keyword=values 
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Parameter 
/keyword=value 


Either a device characteristics keyword or a memory allocation 
keyword. The device characteristics keywords are listed below: 


/BUF=dev: [size] /REMOTE [=dev: ] 
/CRT [=dev: ] | /RPA [=dev: ] 
/ESCSEQ [=dev:] /SLAVE [=dev: ] 
/EBC [=devs: ] /SPEED=dev: [recv:xmit] 
/ECHO [=dev: ] /SYSUIC [=uic] 
/FDX [=dev: ] /TERM=dev: [value] 
/FORMFEED [=devs ] /TYPEAHEAD [=dev] 
/HFILL=dev: [value] /UIC[=uic[:dev:] ] 
/HHT [=dev: ] /VFILL [=dev: ] 
/LINES=dev: [value] WCHK [=dev: ] 

/ LOWER [=dev: ] /WRAP [=DEV:] 


/PRIV [=dev: ] 


The memory allocation keywords are listed below: 


BOT POOL 
PAR POOLSIZE 
NOPAR TOP 


Device Characteristics Keywords 
/BUF=dev: [size]. 


Sets or displays the default buffer size of the specified device. 
If you omit the buffer size, this keyword causes the current size 
to be displayed. The size you specify must be greater than 0 and 
less than or equal to 255 decimal (for a terminal, the buffer 
size must be greater than or equal to two). BUF is’ particularly 
useful for defining line printer width (80 or 132 columns). 


/CRT [=dev:], 


The dev: is not a cathode ray tube (CRT) terminal. The CRT 
keyword defines the terminal as a CRT and enables the backspace 
deletion option. When the backspace deletion option is enabled, 
typing the RUBOUT or DELETE key moves the printing position one 
Space to the left and erases any character displayed in that 
position. 


When you omit the device specification, VMR displays all the 
devices that are defined as CRTs. 
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/NOCRT[=dev:], 


The dev: is a cathode ray tube (CTR) terminal. The NOCRT 
keyword deletes the CRT status of the specified device and 
disables the backspace deletion option. 


When you omit the device option, VMR displays all the terminals 
that are not defined as CRTs. 


/ESCSEQ [=dev: ] 


The dev: is a terminal. The ESCSEQ keyword enables’ the 

recognition of escape sequences from the specified terminal. The 

terminal driver treats the ESC character as the beginning of an “ 
escape sequence rather than as a line terminator. See the 

RSX-11M I/O Drivers Reference Manual for further information 

about escape sequences. 


When you omit the device specification, VMR displays all the 
terminals that recognize escape sequences. 


/NOESCSEQ [=dev: ] Man, 


The dev: is a terminal. The NOESCSEQ keyword disables’ the 
recognition of escape sequences at the specified terminal. 


When you omit the device option, VMR displays all the terminals 
that do not support the recognition of escape sequences. 


/EBC [=dev:], 


The dev: is a terminal. The EBC keyword enables the eight bit 
character option. The full duplex terminal driver will pass all ME 
8 bits of the input characters to the specified device. 


When you omit the device specification, the system will display 
the devices that have the eight bit character option enabled. 


/NOEBC [=dev:], 


The dev: is a terminal. The NOEBC keyword disables the eight 
bit character option. The full duplex terminal driver strips off 
the parity bits of the input characters before passing them _ to 
the device. _, 


When you omit the device specification, the system will display 
the devices that do not have the eight bit character option 
enabled. 


/ECHO[=dev:], 


The dev: is a terminal. The ECHO keyword enables the echo 
option. The full duplex terminal driver will display each 
character that is typed on the specified device. 


When you omit the device specification, the system will display 
the devices that, have the echo option enabled. 
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/NOECHO [=dev: ] 


The dev: is a terminal. The NOECHO keyword disables the _ echo 
option. The full duplex terminal driver will not display the 
characters that are typed on the terminal. 


When you omit the device specification, the system will display 
the devices that have the echo option disabled. 


/FDX[=dev:], 


The dev: is a terminal. The FDX keyword enbles the full duplex 
option. The full duplex terminal driver will accept input from 
the specified device while simultaneously outputing to it. 


When you omit the device specification, the system will display 
the devices that have the full duplex option enabled. 


/NOFDX [=dev:], 


The dev: is a terminal. The NOFDX keyword disables the full 
duplex option. The full duplex terminal driver will not process 
input and output from the specified device simultaneously. 


When you omit the device specification, the system will display 
the devices that do not have the full duplex option enabled. 


/FORMFEED [=dev:], 


The dev: is a terminal. The FORMFEED keyword indicates that the 
specified device has a hardware formfeed. 


When you omit the device specification, VMR will display the 
devices that have hardware formfeeds. 


/NOFORMFEED [=dev:], 


The dev: is a terminal. The NOFORMFEED keyword indicates that 
the specified device does not have a hardware formfeed. 


When you omit the device specification, VMR will display the 
devices on the system that do not have hardware formfeeds. 


HFILL=dev: [value] 


The value is a number between O and 7. The HFILL keyword 
specifies the number of file characters that the full duplex 
terminal driver is to place after a carriage return when 
outputing to the specified device. 


When you omit the value parameter, VMR will display the number of 
fill characters currently being output by the device driver to 
the specified device. 


/HHT [=dev:], 
The dev: is a terminal. Full duplex terminal driver only. The 


HHT keyword: indicates that the specified device has a hardware 
horizontal tab. 


When you omit the device specification, VMR will display the 
terminals on the system that have hardware horizontal tabs. 
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/NOHHT {=dev:], 


The dev: is a terminal. Full duplex terminal driver only. The 
NOHHT keyword indicates that the specified device does not have a 
horizontal tab. 


When you omit the device specification, VMR will display all of 
the terminals that do not have hardware horizontal tabs. 


/LINES=dev: [value], 


The value is a number between 1-255 that establishes the number 

of lines per page on the specified device. If you specify a 

number that is larger than the number of lines per page possible dei 
for a given device, VMR will default to the largest number 

possible for that device. 


When you do not specify a value, VMR will display the lines. per 
page for the specified device. 


/ LOGON 


Enables logging onto terminals in a multiuser protection system. am 


/NOLOGON 


Disables logging onto terminals in a multiuser protection system. 
LOGON and NOLOGON clear and set a flag checked by the HELLO 
command when a user attempts to log onto a_ terminal. This Set 
option provides a means of preventing users from accessing the 
system during system maintenance or account file maintenance 
activity, for example. 


/LOWER[=dev:], : a=, 


The dev; is a terminal. The LOWER keyword specifies that 
lower-case characters are not to be converted to upper case when 
they are received from the specified terminal. 


When you omit the device specification, VMR will display all 
terminals for which lower-case characters are not converted. 


/NOLOWER [=dev:], 


The dev: is a terminal. The NOLOWER keyword resets the terminal ~~ 

characteristics of the specified terminal so that lower-case 

characters received on input are automatically converted to upper 

case and echoed aS upper case. 

When you omit the device specification, VMR will display all 

terminals for which conversion to upper case is specified. 
/PRIV [=dev:], 

The dev: is a terminal. The PRIV keyword sets the specified 

terminal to privileged status. 

When you omit the device specification, VMR will display all 

privileged terminals on the system. 4 
NOPRIV /NOPRIV[=dev:]. 

Sets the identified terminal to nonprivileged status. Absence of 

=dev: results in a display of all nonprivileged terminals. a, 
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/REMOTE [=dev:], 


The dev: is a terminal with a line to a DZ1l multiplexer. (The 
line can also be a DH11 with the full duplex terminal driver.) 
The REMOTE keyword declares that the specified terminal is 
connected to a modem and can therefore be connected to the system 
by means of a dial-up network. 


When you omit the device specification, VMR will display all 
remote lines (including DHl1 lines). 


/NOREMOTE [=dev:], 


The dev: is a line to a DZ11 multiplexer. (The line can also be 
a DH11 with the full duplex terminal driver.) The NOREMOTE 
keyword establishes the terminal's line as a local line not 
connected to a modem. 


When you omit the device specification, VMR will display all 
local lines (including DL11, DH11, DJ11l, and DZ11 multiplexers). 


/RPA[=dev:], 


The device is a terminal. The RPA keyword enables the 
read-pass-all option. The full duplex terminal driver will pass 
all characters input at the - keyboard to the terminal's input 
buffer. 


When you omit the device specification, VMR will display all of 
the devices on the system that have the read-pass-all option 
enabled. 


/NORPA[=dev:], 


The dev: is a terminal. The NORPA key word disables’ the 
read-pass-all option. The full duplex terminal driver will not 
pass special function characters (for example CNTRL C) input at 
the keyboard to the terminal's input buffer. 


When you omit the device specification, VMR will display all the 
devices on the system that have the read-pass-all option 
disabled. 


/SLAVE [=dev: ] 
The dev: is a terminal. The keyword establishes the specified 
terminal as one that can enter data only if it is solicited from 


a task; thus, the specified terminal always rejects unsolicited 
input (other than CTRL/O, CTRL/Q, and CTRL/S). 


When you omit the device specification, VMR will display all 
terminals currently classified as slaved. 


/NOSLAVE [=dev:], 


The dev: is a terminal. The NOSLAVE keyword sets the specified 
terminal to nonslave status. 


When you omit the device specification, VMR will display all 
terminals currently classified as nonslave. 
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/SPEED=dev: [recv:xmit], 


The dev: is a terminal. The recv argument is the baud rate at 
which characters are input to the computer from the terminal. 
The xmit argument is the baud rate at which the computer outputs 
characters to the terminal. The SPEED keyword establishes the 
receive and transmit baud rate for terminals attached to the 
System through a DH11 or DZ1l multiplexer. You must specify both 
arguments when setting the speed. If you do not specify either 
VMR will display the current settings. 


Valid baud rates for the DH1ll are: 0, 110, 150, 200, 300, 600, 
1200, 1800, 2400, 4800, 9600. A (user-specified baud rate A), 
and B (user-specified baud rate B). Valid baud rates for the 
DZ11_ are: 0, 110, 150, 300, 600, 1200, 1800, 2000, 2400, 3600, 
4800, 7200, and 9600. The receive and transmit baud rates’ for 
the DZ1l must be the same; the DZ11 does not support split 
speeds. 


/SYSUIC[=uic], 


The uic has the format [g,m] and g and m are octal numbers’ that 
represent a group and member respectively. The /SYSUIC keyword 
establishes the UIC for the system and all system tasks. On most 
systems, the system UIC is [1,54]. These UIC values are the 
initial defaults on virgin systems. 


This UIC becomes the default UIC used by the Load command and the 
install-run-remove option of the Run command. 


When you omit the UIC specification, VMR will display the current 
UIC. 


/TERM=dev: [value], 


The dev: is a terminal and value is a RSX-11M supported terminal 
type. The TERM keyword establishes the terminal type of the 
specified device. When VMR- sets” the terminal type, it 
automatically sets the HFILL, VFILL, CRT, FORMFEED, and HHT 
characteristics for the terminal. The standard terminal types 
are as follows: 


ASR33 ASR35 KSR33 LA30P 
LA30S LA36 LA120 LA180S 
VTO5B VT50 VT52 VT55 
VT6l VT100 


If you specify a terminal type that is unknown to VMR, VMR_ will 
not set any device characteristics for the terminal. However, 
VMR will store the value you have specified in the Unit Control 
Block (UCB). 


When you omit the value parameter, VMR will display the terminal 
type of the specified device. 


Note that VMR will also accept another form of the SET command, 
as follows: 


SET /term-type=dev: 
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term-type 

One of the standard terminal types listed above 
dev: 

An ASCII device name 


For example, SET /VT52=TT16: is equivalent to SET 
/TERM=TT16:VT52. 


/TYPEAHEAD [=dev:], 


The dev: is a_ terminal. The TYPEAHEAD keyword enables’ the 
TYPEAHEAD option for the specified device. The full duplex 
terminal driver will buffer input characters before passing them 
to a requesting task. Thus characters input during periods 
between requests will not be lost. 


/NOTYPEAHEAD [=dev:], 


The dev: is a terminal. The NOTYPEAHEAD keyword disables’ the 
TYPEAHEAD option for the specified device. The full duplex 
terminal driver will not buffer characters to prevent their loss. 


/UIC[=uic[:dev:]] 


The specified UIC is established as the default UIC for the 
entering terminal unless’ dev: is specified. If you specify 
dev:, the default UIC is set for that terminal. All tasks run 
from the terminal are run with the UIC of the terminal, except in 
a multiuser protection system. In such a system, a _ privileged 
user can override the terminal UIC with the UIC switch in the RUN 
command. Further, external MCR function tasks are requested 
with this UIC. 


When you do not specify uic (SET /UIC), the current UIC is 
displayed. If only dev: is specified (SET /UIC:dev:), the UIC 
for the specified terminal is displayed. 


/VFILL[=dev:], 


The device is-a terminal. The VFILL keyword enables the vertical 
fill characters option for the specified device. The full duplex 
terminal driver will add 4 fill characters following each 
linefeed. 


When you omit the device specification, VMR will display all of 
the terminals on the system that have the VFILL option enabled. 


/NOVFILL[=dev:], 


The device is a terminal. The NOVFILL keyword disables’ the 
vertical fill characters option for the specified device. The 
full duplex terminal driver will not add any verticle file 
characters following linefeeds. 


When you omit the device specification, VMR will display all of 
the terminals on the system that do not have the VFILL option 
enabled. 


ee: 


1 These tasks are the MCR MOUNT, INSTALL, DMO, and UFD commands 
(which run as tasks) and all system-supplied software. 
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/WCHK [=dev:], 


The WCHK keyword specifies for all Files-ll devices except DxX:, a, 
DY:, and DL: and magnetic tape (MM:, MS:, and MT:) that all 
writes are to be followed by a write check. This feature 
provides high reliability for data transfers to the specified 
disk. Executive support for write check is a SYSGEN option and 
must be selected for this command to have any effect. 


When you omit the device specification, VMR displays all Files-1ll 
disk drives with write check enabled. 


/NOWCHK [=dev:], 


The NOWCHK keyword specifies that write check is to be disabled 
for the specified device. 


When you omit the device specification, VMR will display all 


disks that support write check, but that have write check 
disabled. 


/WRAP [=dev:], 


The device is a terminal. The WRAP keyword enables the 
wrap-around option for the specified device. The full duplex 
terminal driver will automatically generate a carriage 
return/linefeed sequence when the number of input characters 
exceeds the buffer size of the specified device. Both the 
carriage return and linefeed are transparent and do not appear in 
the input buffer. 


When you omit the device specification, VMR will display all of 


the terminals on the system that have the wrap-around options 
enabled. 


/NOWRAP [=dev: ] 


The device is a terminal. The NOWRAP keyword disables the wrap 
around option for the specified device. The full duplex terminal 


driver will not accept input characters beyond the input buffer 
size. 


When you omit the device specification, VMR will display all of 


the terminals on the system that have the wrap around option a 
disabled. | 
Example 


>SET /BUF=LP0: 
BUF=LP0:132. 


Displays the current buffer size of LPO: 
>SET /BUF=TT1:40. 

Set TTl: buffer size to 40(10). 
>SET /CRT=TT3: 


Enable the backspace deletion option on the display terminal 
TTS $s 


>SET 
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/CRT 


CRT=TT3: 


Display all terminals that support the backspace deletion option. 


>SET 


Establish terminal TT3: as a terminal that can send 


/ESCSEQ=TT3: 


sequences, 


>SET 


/ESCSEQ 


ESCSEQ=TT3: 


Display 
>SET 
Disable 


2SET 
2SET 


all terminals that can send escape sequences. 
/NOESCSEQ=TT3: 
Support of escape sequences on TT3:. 


/LA30S=TT2: 
/LA30S 


LA30S=TTO: 
LA30S=TT2: 


Set TT2: 
Display 


2SET 
Set TTO: 


>SET 


PRIV= 
PRIV= 


Display 
SET 


Set the 
line, 


>SET 


as an LA30S. 
all LA30S terminals. 


/PRIV=TTO: 
to a privileged terminal. 
/PRIV 
i 8 
TTiLs 
all privileged terminals. 


/REMOTE=TT21: 


terminal line corresponding to TT21: aS a remote 


/REMOTE 


REMOTE=TT1: 
REMOTE=TT2: 
REMOTE=TT3: 
REMOTE=TT4 : 
REMOTE=TT21: 


Display 
lines. 


all terminals that are currently set as remote 


TTl:, TT2:, TT3:, and TT4: 


>SET /SLAVE=TT3: 


Set TT3: 


to a slave terminal. 


>SET /WCHK=DK1: 


Enable write check on DKl:. 


escape 


dial-in 


dial-in 
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Memory Allocation Keywords 


/BOT=pname: value, 


The pname is a l- to 6-character alphanumeric partition name and 

value a number of 64-byte blocks. The BOT keyword directs VMR to 

move the bottom boundary of the specified system-controlled 

partition up or down the amount indicated by the value parameter. 

The BOT keyword modifies the bottom boundary of a partition even = 
though it has tasks installed in it. I£ you contract a partition 

that contains an installed task or loaded driver, VMR displays a 

warning message; the task or driver may no longer fit in the 

partition. 


The value parameter can be supplied in five formats: 


+value 


Moves the bottom boundary up by the specified amount. Moving 
the bottom boundary up makes the partition smaller. 


NOTE 


You can supply the value in the same 
units as the base and size parameters in 
the MAIN keyword described below. 


-value 


Moves the bottom boundary down by the specified amount. 
Moving the bottom boundary down makes the partition larger. am, 


value 


Establishes the total partition size equal to the specified 
value by moving the bottom of the partition. 


+*or* 


Moves the bottom boundary up as far as’' possible. Note that 
using this format will cause the bottom boundary to move up to 


the bottom of the first fixed task or driver loaded into the _.. 
partition at the time the BOT keyword is executed. If there we 
is nothing loaded into the partition, it will assume a size of 
1 64-byte block. 
_%* 
Moves the bottom boundary down as far as possible. Using this 
format will cause the bottom boundary of the partition to move 
down to the top boundary of the partition below it or to’ the . 
top of the Executive if the effected partition is the lowest 
partition in memory. 
/MAIN=pname [:base:size: type] 
Establishes a main partition. ss 
pname 
The l1- to 6-character alphanumeric partition name. RE, 
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sbase 


The physical base address of the partition specified as a 
number of 64-byte blocks. 


:size 
The size of the partition specified as a number of 64-byte 


blocks. The maximum size is 0 to 1920.K words for a task, 
common, or main partition. . 


: type 
SYS for a main partition, DEV for a common partition that maps 
the device registers, COM for a common partition, or TASK for 
a task partition. 


Main partitions are allocated for user tasks and loadable 
drivers. 


Device partitions are allocated for device commons which are used 
by tasks to access the device registers on the I/O page. 


You may enter base and size in any of the following formats; 


Format Calculated Value 

nnnn Octal (nnnn*100) 

nnnn. Decimal (nnnn.*64.) 
nnnK Octal K (nnn*4000) 
nnn.K Decimal K (nnn.*2048.) 


nnnn is a number to which a multiplication factor is applied to 
determine the value used. Valid ranges of calculated values are: 


‘Octal 0<=base<177777 0<size<2000 
Decimal 0.<=base<65535 0.<size<1024. 
Octal K OK<=base<3777K OK<size<40K 
Decimal K 0.K<=base<2047.K 0.K<size<32.K 


For system controlled partitions, size may range from 0 to 1920.K 
or any valid representation of these limits. 


You can specify the base address of a partition through a 
wildcard (*) for TASK or SYS partitions in a mapped system. When 
you specify a wildcard (*), VMR creates a partition at the lowest 
address possible for a partition of the size you have specified. 


You can also specify the size of a partition through a wildcard 
(*) for SYS partitions. When you specify the wildcard (*), VMR 
creates the largest possible partition starting at the base 
address you have specified in the base parameter. 


When you specify wildcards for both the base and size, VMR will 
create a partition that will completely fill the first gap in the 
existing partition layout. 


If you do not specify base, size, or type, VMR will display the 
values of these parameters for the named partition. If the named 
partition is a main task-controlled partition, VMR also displays 
the parameters of all its subpartitions. 
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/NOMAIN=pname 


SUB 


Eliminates a named partition from the system. The partition you 
specify will be eliminated from the list of partitions and the 
system. If any tasks or commons are installed in or attached to 
the partition, the partition will not be eliminated and VMR will 
generate an error message. 


is the keyword that establishes a subpartition. Subpartitions 
may only be established in user-controlled main partitions. 


mMmname 


is the 1- to 6-character main partition name. The 
subpartition being defined becomes a subpartition in the named 
main partition. 


:pname 
is the 1- to 6-character subpartition name. The subpartition 
being defined becomes a subpartition of the main partition 
specified in mname. 


sbase 


is the physical base address of the subpartition, specified as 
a number of 64-byte blocks. 


:size 


is the size of the subpartition, specified as a number of 
64-byte blocks. 


Base and size may be entered in any of the following formats; 
nnnn is a number to which a multiplication factor is applied to 
determine the value used. 


Format Calculated Value 

nnnn Octal (nnnn*100) 

nnnn. Decimal (nnnn.*64.) 
nnnK Octal K (nnn*4000) 
nnn.K Decimal K (nnn.*2048.) 


Valid ranges of values are: 


Octal 0<=base<10000 0<size<2000 
Decimal 0.<=base<4096. 0.<size<1024,. 
Octal K OK<=base<200K OK<size<40K 


Decimal K 0.K<=base<2047.K 0O.K<size<32.K 
Example: 


Any of the following inputs for size will allocate a 2048. byte 
subpartition. 


40 
32. 
1K 
1.K 


If base and size are omitted, the current values will be 
displayed for the named subpartition. 


8-44 


”. 
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NOSUB 


is the keyword that eliminates the named subpartition from _ the 
system. 


/POOL[{=TOP ] 
Increases the size of the dynamic storage region. 
TOP 


The first location in memory used for partition allocation. 
You specify TOP in units of 64-byte blocks. You can specify 
it in octal or decimal. When you do not specify TOP, VMR 
displays the current top of memory, the size of the longest 
block of pool space in words, and the total number of words in 
the pool. The display's format is: 


POOL = top:max:total 


where top is given in units of 64-byte blocks, and max and 
total are in decimal words. 


You can specify TOP as a wildcard (*). The wildcard directs VMR 
to supply the maximum amount of pool possible. Specify the 
wildcard as follows: SET /POOL=*., 


If more pool is requested than can be supplied, a warning message 
is printed, and the maximum amount of pool possible is supplied. 


/POOLSIZE [=value] 


This command allows you to specify a total amount of pool rather 
than a top address. If you do not specify a value, VMR will 
display the current top of memory, the size of the longest block 
of pool space in words, and the total number of words in the 
pool. 


/TOP=pname: value 


Where pname is a 1- to 6-character alphanumeric partition name 
and value is a number of 64-byte blocks. The TOP keyword directs 
VMR to move the top boundary of the specified system-controlled 
partition up or down the amount indicated by the value parameter. 
The TOP keyword modifies the top boundary of a partition even if 
the partition has tasks installed in it. If you modify the 
partition so that it is too small to hold the tasks installed in 
it, VMR will display a warning message and modify the partition 
anyway. 


The value parameter can be supplied in five formats: 
+value 
Moves the top boundary up by the specified amount. Moving the 
top boundary up makes the partition larger. 
NOTE 
You can supply the value in the = same 


units as the base and size parameters in 
the PAR keyword described above. 
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-value 


Moves the top boundary down by the specified amount. Moving 
the top boundary down makes the partition smaller. 


value 


Establishes the total partition size equal to the _ specified 
value. 


+e Ore 


Moves the top boundary up as far as_ possible. Using this 
format causes the top boundary to move to the bottom boundary 
of the partition above it or to the top of memory if the 
partition is the top partition in memory. 


Moves the top boundary down as far as_- possible. Using this 
format causes the top boundary to move down to the top of the 
first fixed task, driver, or common loaded into the partition 
at the time the TOP keyword is executed. If nothing is loaded 
into the partition, the partition assumes a size of 1 64-byte 
block. 


Examples 


>SET /MAIN=SYSPAR:420:140: TASK 


Define a partition called SYSPAR whose base address is 42000(8) 
and whose length is 14000(8) bytes. 


>SET /MAIN=SYSPAR 
MAIN=SYSPAR:0420:0140: TASK 
SUB=SYSPAR:MCRPAR:0445:0056 


Display the parameters of the main partition SYSPAR and all of 
its subpartitions. 


>SET /NOMAIN=SYSPAR 
Eliminate main partition SYSPAR. 

SET /MAIN=GEN:1000:6000:SYS 
Define a main partition called GEN as a_=e system-controlled 
partition whose base address is 100000(8) and whose length is 
600000(8) bytes. 

>SET /POOL=420 


Define the first location in memory for partition allocation (No 
user defined partition can begin below 42000(8)). 


>SET /POOL 


POOL=0420:150:430. 


The first available location for user partitions is 42000(8); 


the longest free block is 150. words, and the total of all pool 
space is 430. words. 


Notes 
1 e 
ese 
2. 
3. 
4. 
5. 
% F 
6. 
\ _ : 
* 
Ne” 
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If a partition currently hosts installed tasks or loaded 
drivers, and a command (for example, /NOMAIN) attempts to 
eliminate the partition, VMR rejects the command. 


When you define a partition, the name must not already be 
defined as a partition. In addition, a main partition cannot 
overlap any other main partition. (An exception is for DEV 
partitions in the I/O page; these can overlap.) 


The numeric value convention (a number followed by a_ period 
(.) is explicitly decimal) applies to all the SET command 
numeric values. 


The address specified with the POOL command must be _ lower 
than the base address of the first partition in the system 
with the exception of partition LDR for a resident loader, 
which is in the Executive; LDR for loadable Loader. 


Once you have allocated space to the dynamic storage region, 
you cannot recover the space for use in partitions (you 
cannot contract pool). 


If the last partition is system-controlled, its top address 
is modified by Save at boot time to reflect the actual top of 
physical memory of the hardware in use. 


TAS 


TASKLIST 


Use the TASKLIST command to display a description of each 
task in the system. The display contains in columnar form, 
to right: 

l. Task name 

2. Task version identification 

3. Task Control Block (TCB) address 

4. Partition name 

5. Task priority 

6. Size of task in bytes (octal) 

7. Load device identification 

8. Disk address logical block number (octal) in a virgin system, 

and the image or task file identification in a saved system 
image 

9. Task memory state 
Format 

TAS [KLIST] 
Example 
VMR> TAS 
»+eLDR 10 115450 LDRPAR 248. 00002400 LBO:- FILE ID:(2177,15) FIXED 
TKTN 03.94 113400 TKNPAR 248. 00010000 LBO:- FILE ID: (2247,14) 
MCR... 02.01 114300 SYSPAR 160. 00010000 LBO:- FILE ID: (2234,15) 
-eeMCR Ol 112500 GEN 160. 00012000 LBO:- FILE ID: (2251,14) 
F11ACP M0320 115200 GEN 149. 00024000 LBO:- FILE ID: (2252,14) 
DBOFCP M0320 115100 GEN 149. 00063500 LBO:- FILE ID: (15221,124) 
~«eDMO 22.00 114700 GEN 140. 00040000 LBO:- FILE ID:(2230,14) 
»e«eINI 20.01 114500 GEN 140. 00040000 LBO:- FILE ID: (2232,14) 
»«-MOU 22.15 114200 GEN 140. 00040000 LBO:- FILE ID: (2240,14) 
-«eUFD VO0410 113700 GEN 140. 00040000 LBO:- FILE ID: (2246,14) 
PMD... 04 113300 GEN 130. 00020000 LBO:- FILE ID: (3775,30) 
SHF... 04 113200 SYSPAR 105. 00010000 LBO:- FILE ID: (3256,546) 
ee«eINS 04 114400 GEN 100. 00040000 LBO:- FILE ID: (2231,14) 
o«eSAV 04.22 114100 GEN 100. 00040000 LBO:- FILE ID: (2237,14) 
~-eBAD 05 112600 GEN 100. 00137700 LBO:- FILE ID: (1462,23) 
ooeAT. 04.24 114600 GEN 65. 00057700 LBO:- FILE ID: (1467,15) 
-oeBOO 03.4 115000 GEN 50. 00040000 LBO:- FILE ID: (2226,14) 
oeAco. 02 113600 GEN 50. 00040000 LBO:- FILE ID: (2224,14) 
LPINIT 01 113500 GEN 50. 00015500 LBO:- FILE ID: (4346,32) 
~oePIP M1332 113100 GEN 50. 00054200 LBO:- FILE ID:(1511,15) 
~.-LOA 03.3 113000 GEN 50. 00040000 LBO:- FILE ID: (2233,15) 
»»-UNL 02.8 112700 GEN 50. 00040000 LBO:- FILE ID: (2250,14) 


VMR> 
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installed 
from left 


VMR COMMANDS 


On a system image generated for a PDP-11/70 with more 


words 


of 


rather than 6-digit numbers. 


image. 


FIXED indicates that the task is fixed in 


VMR>TAS 

- LDR. LDR 
TKTN 

-+-—MCR 

ee eDYS GEN 
F11ACP 

« « eDMO GEN 
--INI GEN 
- + -MOU GEN 
- + UFD GEN 
PMD... 
SHF... 

«eI NS GEN 
2 OAV GEN 
- « —BAD GEN 
PRT... 

» » -BOO GEN 
~ + ACS GEN 
see P IP GEN 
e+ PSE GEN 
~+ AT. GEN 


The preceding display is from a saved system. 
in that the file ID of the task file, 
is displayed. 


virgin 


the logical block number, 


SYSPAR 
SYSPAR 


system 


FCPAR 


PMDPAR 
SYSPAR 


PMDPR 


000000 
010000 
010000 
010000 
026000 
040000 
040000 
040000 
040000 
020000 
010000 
040000 
040000 
040000 
020000 
040000 
040000 
054300 
031600 
040000 


LBO:- 
LBO:- 
LBO:- 
LBO:- 


LBO:- 


LBOs- 
LBO:- 
LBO:- 
LBO:- 
LBO:- 
LBO:- 
LBO:- 
LBO:- 


LBO:- 


LBO:- 
LBO:- 
LBO:- 
LBO:- 
LBO:- 
LBO:- 


FILE 
FILE 
FILE 
FILE 
FILE 
FILE 
FILE 
FILE 
FILE 
FILE 
FILE 
FILE 
FILE 
FILE 
FILE 
FILE 
FILE 
FILE 
FILE 
FILE 


memory. 


than 124K 


memory, the size field (fifth column) contains 8-digit 
This display is for a virgin system 


ID:(0,0) FIXED 


ID: (2572,11) 
ID: (2563,11) 
ID: (2565,11) 
ID: (2576,11) 
ID: (2556,11) 
ID: (2557,11) 
ID: (2567,11) 
ID: (2573,11) 
ID: (2610.12) 
ID: (2606,11) 
ID: (2562,11) 
ID: (2570,11) 
ID: (6162,34) 
ID: (5210,6) 

ID: (2273,30) 
ID: (1066,22) 
ID: (2627,11) 
ID: (5552,4) 

ID: (5013,4) 


It differs from a 


rather than 


TIM 


TIME 


VMR COMMANDS 


Use the TIME command to set the time of day and the date, or _ to 
display the time and date. 


Formats 
TIM[E] 
or 
TIM[E]} 
Parameters 
hrs 
mins 


secs 


ml 
m2 
day 


year 


Examples 


>TIM 


{hrs:mins[:secs]] [ml/day/year] 


{hrs:mins[:secs]] [day-m2-year] 


Hours (range O through 23). 
Minutes (range 0 through 59). 


Seconds (range 0 through 59); this parameter is 
optional. 


Numeric representation of month (range 1 through 12). 
Three-letter abbreviation for month. 
Day (range 1 through 31). 


Year (range 0 through 99). Year is relative to 1900; 
thus, 1977 is entered as 77. 


10:23:31 03-MAY-79 


Display the current system image time and date. 


>TIM 1:30 5/3/79 


Set the time to 01:30:00 and the date to 03-MAY-79 


Notes 


1. If you specify neither time nor date, VMR displays’ the 
current system image time and date. 


2. If you specify the time and date, VMR sets the system image 


clock 


and calendar. If you specify only the time, VMR sets 


only the clock; if you specify only the date, VMR sets’) only 
the calendar. 


3. You can specify the time and date in any order. 


4. All numeric values are decimal. No terminating period is 


used. 


weer 
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UNF 


UNFIX 


Use the UNFIX command to free a fixed task from the system image. 
UNFIX is the complement of the FIX command. 


If a fixed task exits or aborts, it still occupies the system image 
memory of the partition. 


Format 
UNF [IX] taskname 
Parameter 
taskname 
The task that you wish to unfix in memory. 
Example 
>UNFIX XKE 


Unfix task XKE, freeing the partition in which it resides. 
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UNL 


UNLOAD 


Use the UNLOAD command to remove a loadable device driver from. the 
system image. If a device is attached, its driver cannot be unloaded. 


To unload a device driver from the system image, the driver's STB file 
must reside on the same disk and under the UFD that corresponds to the 
UIC of the system image file. 


The UNLOAD command cannot remove a data base from the system image, 
even if the data base was loaded by means of the LOAD command. 


Format 
UNL[OAD] dd: 
Parameter 
dd: 
A 2-character ASCII device name 
Example 


VMR>UNL LS: !UNLOAD LPS11 DRIVER (LSDRV) 
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8.6 VMR ERROR MESSAGES 


Following are the VMR command error messages. When a VMR_ error 
message applies to more than one command, the applicable command is 
indicated above the associated message description. 


VMR -- ADDRESSING EXTENSIONS NOT SUPPORTED 


INSTALL 
You are trying to install a task that was built using the VSECT 
(Virtual section) directive into a system image that does not 
Support the VSECT feature. 


VMR -- ALIGNMENT ERROR 


The base address or size of the partition you are attempting to 
create conflicts with existing partitions or physical memory. 


VMR -- BASE ADDRESS MUST BE ON A 4K BOUNDARY 
INSTALL 
The virtual base address of your task is not aligned on a 4k 
boundary. 
VMR -- BASE MISMATCH COMMON BLOCK <common-name> 
INSTALL 


The base address of the partition does not match that of the 
common block. Applicable to unmapped system images only. 


VMR -- CANNOT FIX A TASK IN A SYSTEM CONTROLLED PARTITION 


FIX 
This is a VMR restriction. To fix a task in a system-controlled 
partition, use the MCR Fix command and then save the system 
image. 


VMR -- CANNOT INSTALL TASKS FROM OTHER THAN LB: 


INSTALL 
When you SAVE a system, SAVE deletes from the system image all 
tasks and commons that were not installed from the library device 
LB:. Therefore, you cannot install a task or a common from other 
than LB:. 


VMR -- CANNOT LOAD/UNLOAD A PSEUDO DEVICE 


LOAD AND UNLOAD 
The device name you specified was that of a pseudo device. 
Pseudo devices cannot be loaded or unloaded. 


VMR -- CHECKPOINT AREA TOO SMALL 


INSTALL 
The area you have allocated for checkpointing in your task image 
file is smaller than the partition into which you are attempting 
to install your task. The system image does not support’ the 
dynamic allocation of checkpoint space. 
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-~- CHECKPOINT SPACE TOO SMALL, USING CHECKPOINT FILE 


INSTALL 

This is a warning message. The checkpoint space you _ have 
allocated in your task image file is too small to hold your task 
(usually because of the /INC keyword). The system image supports 
the dynamic allocation of checkpoint space. It will use the 
checkpoint file to store your task when it rolls it out to disk. 
Since no checkpoint file exists when you boot your system, you 
should consider this message to be a fatal error if it is issued 
by any of the system tasks during the boot. These tasks are MCR, 
MOU, SAV, and FI11ACP. 


-- CIRCULAR REDIRECT ERROR 


REDIRECT 
Your attempt to redirect a device has failed because it would 
result in a circular device list. 


-- COMMAND I/O ERROR 


The system has detected an I/0 error during a read from an 
indirect file. 


-- COMMAND SYNTAX ERROR command line 


The syntax of the printed command line is incorrect. 
-- COMMON BLOCK CURRENTLY INSTALLED 


INSTALL 
You are attempting to install a common block that has already 
been installed. 


-- COMMON BLOCK IS A TASK PARTITION common-name 


INSTALL 
A task's request for access to a common block has been rejected 
because the requested partition is a task partition. 


-- COMMON BLOCK NOT LOADED common-name 


INSTALL 
The common block specified by VMR in the error message has been 
linked to your’ task but it has not been installed. The common 
block must be installed before your task can be installed. 


-- COMMON BLOCK OCCUPIED 


INSTALL 
An attempt was made to load a common block that was occupied. 


-- COMMON BLOCK PARAMETER MISMATCH common-name 


INSTALL 
The parameters of the common block named in the error message do 


not match the parameters in the label block of the task that 
references the common. 


-- COMMON BLOCK SEGMENT COUNT ERROR 
INSTALL 
The command attempted to install a resident library with 


overlays, but the number of overlay segments in the task header 
differs from the number specified in the segment descriptors. 
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VMR -- DEVICE ddn: IS ATTACHED 


UNLOAD 
You are attempting to unload a driver that has one or more of its 
device units attached. The first attached unit is ddn:. You 
cannot unload a driver that has device units attached. 


VMR -- DEVICE ddns: NOT IN SYSTEM 
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DEVICES 
The device you requested in the Device command does not exist in 
the system image. 


SAVE 
You are attempting to save an image on a device that does not 
exist on your host system. 


REDIRECT 
You are attempting to redirect I/O requests to a device that does 
not exist on your host system. 


LOAD AND UNLOAD 
You have specified a device in your load command for which’ there 
is no data base. This is caused by one of two conditions: 


1. The device does not exist in the system device tables, 
2. The driver file does not contain a loadable data base. 


INSTALL 
You have specified a device in your INSTALL command that has not 
been defined in the system image. 


-- DEVICE NOT MOUNTED 


You have not mounted the device that contains the system image 
file. 


~- DEVICE NOT REDIRECTABLE 


REDIRECT 
The specified device cannot be redirected. 


-- DRIVER ALREADY RESIDENT 


LOAD 
You have specified a device driver that is already loaded or that 
is permanently resident in the system image. 


-- DRIVER BUILT WITH WRONG STB FILE 


LOAD 
The symbol definition file for the driver is not compatible with 
the Executive symbol definition file for the current system 
image. This means that your driver has been built for another 
system and must be rebuilt before you can load it into the 
current system. 


UNLOAD 
The symbol definition file for the driver is not compatible with 
the symbol definition file of the current Executive. This 
probably means that the most recent copy of the driver is built 
for another Executive. If they exist, try making older versions 
of the driver have the highest file sequence number. 
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-- DEVICE NOT TERMINAL 


SET 
You have attempted to set terminal characteristics for a 
nonterminal device. 


-- DEVICE NOT VARIABLE SPEED MULTIPLEXER 


SET 
You have attempted to set the baud rate for a terminal that is 
not attached to a DH11l or DZ1ll multiplexer. 


-- DRIVER CANNOT BE UNLOADED 


UNLOAD 
You have attempted to unload a permanently resident driver (that 
is, a driver linked to the Executive). 


-- DRIVER NOT LOADED 


UNLOAD 
You have specified a driver in your UNLOAD command that is not 
resident in memory. 


-- DRIVER REQUIRES RUNNING SYSTEM FOR LOAD/UNLOAD 


LOAD 
The driver you have requested has the symbols S$ddLOA or SddUNL in 
its source. RSX-11M does not Support those calls. Note however, 
that these symbols are reserved for future use by the MCR - LOAD 
and UNLOAD commands. 


-- EXECUTIVE IS TOO LARGE 


Your Executive is too large to be accommodated in the system 
image. If your Executive is larger than 16K words, this message 
indicates that you have not included 20K Executive support during 
SYSGEN. If you did include support for a 20K Executive, this 
message indicates that the Executive is larger than 20K. In 
either case, the system is unusable. 


-- FILE name HAS ILLEGAL FORMAT 


LOAD 
Your driver's symbol definition file contains illegal object code 
or data. 


-- FILE name HAS INCONSISTENT DATA 


FIX-IN-MEMORY 
You are attempting to fix a partition or a task that is logically 
beyond the end of the system image file. 


LOAD 
The partition for loadable drivers is logically beyond the end of 
the system image file. 


Your driver task does not conform to the loadable driver 
guidelines or the driver has an invalid loadable data base. 


(Refer to RSX-1I1M Guide to Writing an I/O Driver.) 


INSTALL 
The partition of the common library you are attempting to load is 
logically beyond the end of the system image file. 
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VMR -- FILE name NOT A VALID DRIVER TASK IMAGE 
One of three things has occurred: 
1. Your driver's task image has been overlaid, 
2. Your driver has a header, 
3. Your driver has referenced a resident library. 
VMR -- FILE NOT CONTIGUOUS 
INSTALL 


You have attempted to install a task from a noncontiguous file. 
Task images must be contiguous files. 


LOAD 
The file ddDRV.TSK is not contiguous. This file must be 
contiguous. 
VMR -- FILE NOT FOUND 


You have requested a file that is not in the UFD of the volume 
you have specified. 


VMR -- FILE NOT TASK IMAGE 
INSTALL 
The data in the label block of your task is incorrect, indicating 
that your file is not a task image. 
VMR -- ILLEGAL DEVICE/VOLUME 
SAVE 
You have attempted to save your system image on ané_ invalid 
device. Valid devices are: 
CT: Tape cassette 
DD: DECtape II 
DT: DECtape 
DX: Flexible diskette 
DY: RX02 floppy disk 
MM: TE/TU16/TU45 magnetic tape 
MS: TS04 magtape 
MT: TE/TU10/TSO3 magnetic tape 
PP: Paper tape 
VMR -- ILLEGAL DRIVER TASK APR USAGE 
LOAD 
Your device driver must be built for APR 5 (addresses must start 
at 120,000). 
VMR -- ILLEGAL ERROR SEVERITY CODE code 
This message indicates an internal failure in VMR. If this error 


message persists, contact a Digital software representative. 
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-- ILLEGAL FILE SPECIFICATION file specification 


The file specification printed following the error message has an 
illegal format or contains wild card specifiers. 


~- ILLEGAL FIRST APR 


INSTALL 
You have built your task using an incorrect base APR. The 
following rules apply: 


1. A nonprivileged task must be built with APR 0O as its. base 
APR. 


2. A privileged task that wishes to map the Executive routines 
and data structures must be built with APR 4 as its base APR 
if the Executive is 16K words or less. 


3. A privileged task that wishes to map the Executive routines 
and data structures must be built with APR 5 as its base APR 
if the Executive is 20K words or less. 


4. A privileged task that does not map into the Executive must 
be built with APR 0 as its base APR. 


-- ILLEGAL FUNCTION 
You have entered a command that VMR does not recognize. 
-- ILLEGAL GET COMMAND LINE ERROR CODE 


This error indicates a system failure. If this message persists, 
contact a Digital software representative. 


-- ILLEGAL KEYWORD VALUE 
You have entered a value for a keyword that exceeds its limits. 
-- ILLEGAL OPERATION FOR UNMAPPED SYSTEM 
SET 
The specified keyword (/POOLSIZE) is valid in mapped systems 
only. 
-- ILLEGAL PRIORITY 


INSTALL AND ALTER 
You have specified a priority that is out of range (that is, not 
1 to 250(10), inclusive). 


-- ILLEGAL SWITCH /switch 


The switch printed following the error message is incorrect in 
the context of the command line you have entered. 


-- ILLEGAL USE OF WILDCARD 


SET 
In an unmapped system, specification of a wildcard (*) with the 
/TOP, /BOT, and /POOL keywords is not permitted. Also, you 
cannot specify a wildcard for the "size" parameter with task 
partitions. 
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-- ILLEGAL VALUE FOR SYMBOL symname IN FILE name 


LOAD AND UNLOAD 

LOAD or UNLOAD has determined that symbol symname in the STB file 
name has been defined to an illegal value. This can occur for 
several reasons, some general and some specific to individual 
symbols. For example, in general, most symbols cannot be defined 
to zero or to an odd number. A specific example is the symbol 
SINTSV. SINTSV must not be referenced by mapped loadable 
drivers. 


-- INCORRECT ASSIGNMENT OF SY: OR LB: 

This is a warning message. The device, SY: and LB: are not 
assigned to the same device as the system image file you are 
attempting to VMR. 

-- INDIRECT COMMAND SYNTAX ERROR command line 

You have entered an improper indirect command file specifier. 


~- INDIRECT FILE DEPTH EXCEEDED command line 


You have attempted to exceed more than two levels of indirect 
files. 


-- INDIRECT FILE OPEN FAILURE command line 


The indirect command file in the printed command line could not 
be opened. 


-- INSTALL DEVICE NOT LBO: 


INSTALL 
You have attempted to install a task from other than the boot 
device. 


-- INSTALLED TASKS MAY NO LONGER FIT IN PARTITIONS 


SET 
You have shortened a partition so that the tasks that are 
installed in it may no longer fit. This is a warning message. 
VMR will shorten the partition even though this situation exists. 


-- INTERRUPT VECTOR ALREADY IN USE 


LOAD 
LOAD has determined that your interrupt vector does not point to 
one of the nonsense interrupt entries in the system image. This 
usually means that another driver is using the interrupt vector. 


-- INVALID DRIVER DATA BASE AT OFFSET xxxx IN FILE name 


LOAD 
The driver name has an invalid data base value at offset xxxx 
relative to the symbol SddDAT. 


-- INVALID INTERRUPT VECTOR 
LOAD 


You have specified an interrupt vector address in your driver 
data base that is too high for the current system image. 
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VMR -- INVALID KEYWORD 


You have specified a keyword that is incorrect in the context of rc 
your command. . 


VMR -- INVALID RECORD ADDRESS FOR FILE name 
ANY COMMAND 
The command has attempted to write outside of the system image % 
file or at a byte boundary. Two possible causes are: 
1. A corrupted system image or 
2. An STB file that does not match the system image. . 
VMR -- INVALID SPEED 


SET 
This message can be caused by two things: 


1. You have requested a speed that the multiplexer line you have 
specified does not support. 


2. You have specified unequal receive and transmit speeds for a 
DZ11. The DZ11 does not Support split speeds. 


VMR -- INVALID TIME PARAMETER 
RUN 
The date or time field you have specified is incorrect. 
VMR -- INVALID UIC 
You have specified an illegal value for either a group number or am, 


a member number. 
VMR -- I/O ERROR ON INPUT FILE filename 


An input I/O error occurred on the indicated file. 


VMR -- I/O ERROR ON OUTPUT DEVICE 
SAVE 
SAVE has encountered an I/O error on the output device while YN 
writing the system image. TS 
VMR -- I/O ERROR ON OUTPUT FILE filename 


An output I/O error occurred on the indicated file. 
VMR - KEYWORD NOT SUPPORTED FOR THIS TERMINAL DRIVER 


SET 
The terminal driver specified during SYSGEN does not support’ the ° 
specified keyword (for example, typeahead is a full duplex 
terminal driver option only and your system contains the half 
duplex driver). 
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-- LENGTH MISMATCH COMMON BLOCK blockname 


INSTALL 
The length parameter for the common block, as described in the 
label block for the task image, does not match the corresponding 
length parameter defined in the system image. A task's' label 
block data must match system data for that task before it can be 
installed. 


-- LINE NOT D211 


SET 
You have attempted to set a line to remote that is not attached 
to a DZ11 and your system contains the half duplex terminal 
driver. 


-- LOADABLE DRIVER SUPPORT NOT IN SYSTEM 


LOAD AND UNLOAD 
You have attempted to load a device into or unload a device from 
a system image that does not support loadable device drivers. 


-- LOGICAL DEVICE NOT IN SYSTEM 


ASSIGN 
The device you have specified has not been defined and therefore 
ASSIGN cannot find it in the logical device assignment table. 


-- LUN OUT OF RANGE 


REASSIGN 
You have attempted to reassign a LUN number that is higher’ than 
the maximum number of LUNs that you allocated at task build. 


-- NO CHECKPOINT SPACE, ASSUMING NOT CHECKPOINTABLE 


- INSTALL 
This is a warning message. You have attempted to install a_ task 
as checkpointable that you have not built as checkpointable. 
This means that there is no checkpoint space allocated in the 
task image file. Since your system does not support the dynamic 
allocation of checkpoint space, INSTALL does not consider’ the 
task to be checkpointable. 


~- NO LUNS 


LUN 
The task that you have specified as an argument of the LUN 
command does not have any logical units assigned to it. This is 
not an error message; rather, it is simply an indication that 
there are no assignments to display. 


-- NO POOL SPACE 
LOAD 


The pool space required by the driver is not available in the 
system image. 


VMR -- NON EXISTENT MEMORY 


SET 
You have attempted to define a partition in nonexistent memory. 
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-- NOT ENOUGH APRS FOR TASK IMAGE 


INSTALL 
The Task Builder allows you to specify the virtual base address 
of a task image as a multiple of 4K. Privileged tasks that 
access the Executive start at either virtual 100000(8) or at 
120000(8) depending on the size of the Executive. If the virtual 
base address of the task is set too high, there will not be 
enough APRS remaining to map the task image. (Refer to the 


RSX-11M/M-PLUS Task Builder Manual for information on privileged 


tasks.) 
-- OLD DEVICE ATTACHED 


REDIRECT 
You have attempted to redirect an attached device. 


-- OPEN FAILURE ON FILE filename 
The indicated file cannot be opened. 
-~- PARTITION ALREADY EXISTS 


SET 
You have attempted to define a partition with a name already in 
use. 


-- PARTITION IS BUSY 


LOAD 
The partition into which you attempted to load your driver is 
full, therefore, your task cannot be loaded. 


FIX 
You have attempted to fix a task or common region partition that 
is full, therefore the task cannot be fixed. 


~- PARTITION name IS A COMMON 


LOAD 
You have attempted to load a device driver into a common 
partition. A device driver cannot be loaded into a common 
partition. 


-- PARTITION pname IS NOT A COMMON 


LOAD 
Partition xxCOM was found, but it is not a common partition. 


-- PARTITION pname NOT IN SYSTEM 


LOAD 
You are attempting to load a driver into a partition that does 
not exist in the system or LOAD found a symbol $xxCOM in the 
driver and partition xxCOM does not exist in the system. 


-~- PARTITION pname IS TOO SMALL 
INSTALL 


You are attempting to install a task that is too large for _ the 
partition you have specified. 
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-- PARTITION NOT COMMON 


INSTALL 
A partition specified for a common area or library is not defined 
aS a common partition. 


-~- PARTITION NOT IN SYSTEM 


LOAD 
The partition you have specified is not in the system image. 


-- PARTITION NOT SYSTEM CONTROLLED 


SET 
The /TOP and /BOT keywords are valid for system controlled 
partitions only. 


-- PARTITION par NOT IN SYSTEM, DEFAULTING TO GEN 


INSTALL 
This is a warning message. You have attempted to install a_ task 
in a partition that does not exist. VMR will attempt to install 
the task in the partition GEN. 


-~- PRIVILEGED TASK LARGER THAN 12K 


INSTALL 
You have attempted to install a privileged task that is larger 


than 12K words. (Refer to the RSX-11M/M-PLUS Task Builder Manual 


for information on privileged tasks.) 
-- POOL LINK ERROR AT xxxx BLOCK=yyyy 22Z2z 


SET 
When SET /POOL traced the pool linkage, it detected an error at 
location xxxx in the system image. The contents of xxxx is yyyy 
and the contents of xxxx+2 iS zZzzz. 


-- PSEUDO DEVICE ASSIGNMENT ERROR 


ASSIGN 
You have attempted to assign a logical device name to a _ pseudo 
device. Logical device nameS cannot be assigned to pseudo 


devices. 
-~- PSEUDO DEVICE REDIRECT ERROR 


REDIRECT 
You have attempted to redirect one pseudo device to another 
pseudo device. 


-- RECEIVE DATA OR BY REFERENCE LIST NOT EMPTY 


REMOVE 
A task with entries in its receive queues cannot be removed from 
the system image. 


-- SPACE USED 
SET 


You have attempted to create a partition in a storage area that 
is already occupied. 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR 


VMR COMMANDS 


-- SPECIFIED PARTITION FOR COMMON BLOCK 


INSTALL | 
You are attempting to install a task into a common block. 


-- SPECIFIED PARTITION TOO SMALL 
INSTALL 


You are attempting to install a task into a partition that is 
smaller than the task. 


LOAD 
You are attempting to install a driver into a partition that is 
smaller than the driver. 


-- SYMBOL symname IS DOUBLY DEFINED BY FILE name 
LOAD AND UNLOAD 
The symbol symname is defined twice in file name. Duplicate 
symbols are illegal. 
-- SYMBOL symname IS UNDEFINED IN FILE name 
LOAD AND UNLOAD 
LOAD found the symbol symname in the file name, but the symbol is 
not defined. 
-- SYNTAX ERROR 
You have typed the command incorrectly. 


-- SYSTEM IMAGE IS RSX-11M-PLUS 


You are attempting to use VMR on an RSX-11M-PLUS system image 
file. This will not work and is not permitted. 


-- TASK ACTIVE 


The task you have specified as an argument of your command is 
active. 


~- TASK ALREADY FIXED 
FIX 


You have attempted to fix a task in memory that is already fixed 
in memory. 


- TASK AND PARTITION BASES MISMATCH 


INSTALL 
The base of the partition does not match that of the task being 
installed. Applicable to unmapped system images only. 


-~- TASK IS CHECKPOINTABLE 
FIX 


You have attempted to fix a checkpointable task in memory. 
Checkpointable tasks cannot be fixed in memory. 
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VMR -- TASK IMAGE CURRENTLY INSTALLED 


INSTALL 
You are attempting to install a checkpointable task that has 
checkpoint space allocated in its task image. The task has 
already been installed. The system will allow you to install 
checkpointable tasks more than once’ subject to the following 
rules: 


1. You must allocate checkpoint space for your task in a system 
checkpoint file. 


2. You must use a different name for your task each time you 
install it. 


VMR -- TASK IMAGE I/O ERROR 


INSTALL 
Your device is write-locked. VMR could not read the task-image 
file or could not rewrite the task image header. 


VMR -- TASK IMAGE VIRTUAL ADDRESS OVERLAPS COMMON BLOCK block~name 


INSTALL 
The virtual addresses you have reserved for the task image 
overlap those you have reserved for the common block specified in 
the error message. Corruption of the task image file may have 
caused the overlap. 


VMR -- TASK NAME ALREADY IN USE 
INSTALL 


You have attempted to install a task of the same name as_ one 
already in the system image. 


VMR -- TASK NOT FIXED 
UNFIX 

You have attempted to unfix a task that is not fixed in memory. 
VMR -- TASK NOT IN SYSTEM 

You have referenced a task that you have not installed in the 

system. 
VMR ~-- TI REDIRECT ERROR 

You have attempted to redirect the pseudo device TI:. TI: 


cannot be redirected. 
VMR ~-- TOO MANY COMMON BLOCK REQUESTS 


INSTALL 
You are attempting to install a task that contains too many 
common—-block requests. A task is limited to seven common block 
references. 


VMR -- TOO MANY LUNS 
INSTALL 


You are attempting to install a task that contains more than 
255(10) LUN assignment requests. 
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-- TOP OF POOL SET TO value, REQUESTED AMOUNT NOT AVAILABLE 


SET 
You have requested more pool space than the system can. provide, 
so the maximum amount was used. This is a warning message. 


-- UNDEFINED COMMON BLOCK block-name 


INSTALL 
You are attempting to install a task that references a common 
block that is not defined in the system image. This message may 
indicate that the task was built for another system. 


-- UNKNOWN MAIN PARTITION 


You are attempting an operation on a main partition which does 
not exist in the system. 


-- WARNING - LOADABLE DRIVER LARGER THAN 4K 


LOAD 
You are loading a driver that is larger than 4K words. This is a 
warning message. 


-- WARNING - PRIVILEGED TASK OVERMAPS I/0 PAGE 


INSTALL 

A privileged task that is mapped into the Executive is often 
mapped to the I/O page as well. However, many privileged tasks 
do not require access to the I/O page and can use the extra 4K of 
address space that would be allocated to the I/O page for the 
task image. This message warns that a privileged task that may 
require access to the I/0 page does not have that access. I€ 
your task does not require access to the I/O page, this message 
can be ignored. 


-- WRITE CHECK NOT SUPPORTED FOR DEVICE 


SET 
You have attempted to enable write check on a device that does 
not Support it. Write check is supported for all disks except 
DL:, DX:, and DY:. 


CHAPTER 9 


SYSGEN PHASE III 


This chapter lists and describes the questions in SYSGEN Phase III. 


9.1 DETAILS OF SYSGEN PHASE III 
Expanded comments for SYSGEN Phase III 


Expanded comments provide descriptions for SYSGEN Phase III 
questions. 


ARE YOU RUNNING ON A MACHINE WITH AT LEAST 24K WORDS 
If the current system has less than 24K-words of memory, the 


utility tasks cannot be built. SYSGEN displays the following 
message and the exits. 


SORRY, YOU CANNOT BUILD ANY UTILITIES AND/OR USER MODE 
DIAGNOSTICS WITH A MACHINE SMALLER THAN 24K WORDS! 


If your system has at least 24K-words, SYSGEN continues. 
ARE YOU BUILDING A MAPPED SYSTEM 


SYSGEN uses the response to this question to determine’ the 
correct system UIC ([1,50] for unmapped, [1,54] for mapped). 


DO YOU HAVE THE DUAL RKO5 DISTRIBUTION KIT 
If you are using the dual, RKO5 kit, you must identify the RKO5 
units that contain the baseline system disk (RSXM26) and the 
utility object files disk (UTLOBJ). SYSGEN asks the _ following 
two questions. 

IN WHICH DEVICE IS THE RSXM26 DISK MOUNTED (ddu: ) 
Enter the RKOS drive that contains the baseline system disk. 

IN WHICH DEVICE IS THE UTILOBJ DISK mounted (ddu:) 
Enter the RKOS drive that contains the utility object files. 


SYSGEN then assigns the utility disk to the pseudo device SY: 
and the baseline system disk to the pseudo device LB:. 
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SYSGEN PHASE III 
If you are not using the dual RKO5 kit, SYSGEN asks the following 
question. 
DO YOU HAVE THE RLO1 DISTRIBUTION KIT 
Enter No if you are using a big disk kit. 
ARE YOU RUNNING ON A MACHINE WITH A LINE PRINTER 
WAS ANSI MAGTAPE SUPPORT SELECTED IN SYSGEN PHASE I 
WAS USER MODE DIAGNOSTIC SUPPORT SELECTED IN SYSGEN PHASE I 
SYSGEN Phase III can build either utility tasks or user wmode 
diagnostic tasks or _ both. The following questions determine 
further action (the second question does not appear if you 


respond No to this question). 


DO YOU WANT TO (RE)BUILD ANY UTILITY TASKS 
DO YOU WANT TO BUILD ANY USER MODE DIAGNOSTICS 


***UTILITY TASKS*** 


IN ORDER FOR THE UTILITY TASKS TO USE ANSI FORMAT TAPE 
THEY MUST BE BUILT WITH THE ANSI FCS ROUTINES. THESE 
ROUTINES MAY CAUSE CERTAIN TASKS TO INCREASE BEYOND THE 
NORMAL 8K SIZE. 


IF YOU WANT TO BUILD THE UTILITY TASKS WITH 
ANSI MAGTAPE SUPPORT, YOU HAVE TO EDIT THE TASK 
BUILD COMMAND FILES FOR THESE TASKS. 
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The task-build command file for a particular utility task 
has to be edited only if the task size turns out to be above 
8K words. This means that SYSGEN3 may have to be run a 
second time. 


MOST OF THE TASKS TO BE BUILT HAVE TASK BUILD 
COMMAND FILES WHICH SPECIFY PARTITION GEN OR 
PAR14K. GEN IS ASSUMED TO BE 40000(8) BYTES LONG 
AND IS ASSUMED TO BE BASED AT 40000(8). 

PAR14K IS A PARTITION WHICH IS 70000(8) BYTES LONG 
AND IS ASSUMED TO BE BASED AT 40000(8). 


For a mapped system, no physical base addresses are required 
for partitions, and the corresponding two lines above are 
suppressed. 
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TASK FTB IS A FAST TASK BUILDER WITH LIMITED FUNCTIONALITY. 
IT DOES NOT SUPPORT OVERLAYS OR GLOBAL CROSS-REFERENCE 

BUT IT IS THREE TIMES FASTER THAN BIGTKB. IT REQUIRES 

A 20K PARTITION TO RUN IN AND IS NOT DISTRIBUTED IN TASK 
IMAGE FORM. YOU MUST BUILD IT IF YOU INTEND TO USE IT. 


THE TASK DSC IS THE DISK SAVE AND COMPRESS UTILITY. IT IS - 
DISTRIBUTED AS A STANDALONE SYSTEM ON ALL DISTRIBUTION SYSTEMS 
AS DSCSYS.SYS. IT MAY ALSO BE BUILT AS A TASK, BUT IS NOT 
DISTRIBUTED IN THAT FORM. IT REQUIRES A 14K PARTITION TO RUN IN. 


ALL OF THE TASK BUILD COMMAND FILES BUILD CHECKPOINTABLE 

TASKS FOR USE WITH SYSTEMS WITH DYNAMIC ALLOCATION OF 

CHECKPOINT SPACE. IF YOUR SYSTEM DOES NOT SUPPORT 

THIS OPTION, INSTALL WILL DEFAULT THEM TO NON-CHECKPOINTABLE. 

IF YOU WISH YOU MAY BUILD TASKS WHICH ARE CHECKPOINTABLE 

AND WHICH ALLOCATE SPACE IN THEIR TASK IMAGE BY CHANGING 

THE /CP SWITCH TO THE /AL SWITCH IN THE BUILD COMMAND FILE. 
NOTE: TASKS WHICH ALLOCATE CHECKPOINT SPACE IN THEIR 
TASK IMAGE REQUIRE MORE DISK SPACE THAN TASKS THAT DON'T. 

SET /UIC=[1,2x] 

INS SEDI 


me TO Ms Ne Te Ne Te Te Te Te Te Ws We NS Te Te Te Te We We WS 


SYSGEN then asks the following question: 
Do you want to E edit and build, B - build task tskname 


where tskname is replaced by the name of the utility (for example, 
MAC). Enter E if you must edit the build command file, B to simply 
build the task, and carriage return to not build the task. SYSGEN 
repeats the above question for the following utility tasks (each task 
listed replaces tskname): 


MAC 
BIGMAC 
TKB 
BIGTKB 
PIP 
FLX 
VFY 
DMP 
EDI 
SLP 
LBR 
PSE 
SYE 
CRF 
ZAP 
BAD 
VMR 
FTB 
CMP 
PAT 
DSC 
CDA 
EDT 
FMT 
IOxX 


If you enter E, SYSGEN invokes EDI and specifies the corresponding 
build command file (tsknameBLD.CMD) to be edited. When you exit EDI, 
SYSGEN builds the task. 
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SYSGEN then installs PIP and BIGTKB. 


DO YOU WANT TO PRINT THE MAPS FOR THE UTILITY TASKS 


The maps for the utility tasks are of little use; normally, 


respond No. 


If you want the maps and specified a line printer, the maps 
be printed on the line printer. If you want the maps but did not 


specify a line printer, they print on your terminal. 
The next display depends on the distribution kit you are using. 
the utility tasks. Read the pertinent section. 
No preparations are necessary for big disk kits. 
**RLO1 KITS** 


DEPENDING ON THE SECONDARY STORAGE MEDIUM AND THE NUMBER 
OF TASKS TO BE COPIED, YOU MAY HAVE TO MOUNT A BLANK MEDIUM 


PER MEDIUM IS: 


FLOPPY DISK AND DECTAPE - 4 TASKS PER DISK OR TAPE 
CASSETTE - 1 TASK PER CASSETTE 


IF YOUR SECONDARY STORAGE IS OTHER THAN RKO5, RLO1 OR MAGTAPE, 
AFTER COPYING A TASK, YOU WILL BE ASKED IF YOU WISH TO MOUNT 
A NEW MEDIUM. IF SO THE INDIRECT FILE PROCESSOR WILL 

PAUSE TO ALLOW TIME TO MOUNT IT. 


THE FOLLOWING ARE LEGAL SECONDARY STORAGE DEVICES: 


DK (RKO5 DISK, FOR RKOS DISTRIBUTION KITS ONLY) 
DL (RLO1 DISK, FOR RLO1 DISTRIBUTION KITS ONLY) 
DX (RXO1 FLOPPY DISK) 

CT (TU60 CASSETTE TAPE) 

DT (TU56 DECTAPE) 

MT (TSO3, TE10, OR TU1O MAGTAPE) 

MM (TU16, TE16, OR TU45 MAGTAPE) 

DY (RX211 FLOPPY DISK) 


me we MO TO TO TO Te We NO We WS Ne We MO TS We We NS Te Te Woe WS Ne 


* 


ENTER DEVICE FOR SECONDARY STORAGE [DDU] [S]: 


IN THE DRIVE AFTER COPYING A TASK. THE RECOMMENDED NUMBER OF FILES 


will 


The 
RLO1 and the dual RKO5 kits require some preparation prior to building 


RKO5,RLO1 AND MAGTAPE (TSO3,RU10,TU16,TU45) - ALL TASKS WILL FIT 


The next query displayed is dependent on your’ secondary 


storage device. 


*DK: or DL: as Secondary Storage Device* 


The following assumes DK: was entered as the _ secondary 


storage device. 
; PUT YOUR TARGET SYSTEM DISK IN DK: 


* IS DK: READY? [Y/N]: 


This query is repeated until the device is ready 


response). 


(Y 


= 
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* ENTER VOLUME LABEL OF DK: ([S]: 
The device is then mounted using this volume label. 
MOU DK: label 
*DX: as Secondary Storage Device* 


If DX: is not loaded, the MCR LOA command is issued. 


LOA DX: 
*CT:,DT:,MT:, or MM:, aS Secondary Storage* 
The following assumes DT: was entered as the secondary 
storage device. 
If the secondary storage device is not loaded, the MCR LOA 
command is issued. 
LOAD DT: 


**DUAL RKOS Kits** 


* DO YOU HAVE AN EMPTY RKO5 REMOVABLE DRIVE AVAILABLE? [Y/N]: 


If not, instructions are given for copying the task image 


files from secondary storage to the system disk. 


If an empty drive is available, you are asked to identify 


the unit number. 
* WHAT IS THE UNIT NUMBER OF THE EMPTY DRIVE? [0 R:0-3]: 
The following assumes that DK2: is the empty drive. 


PLACE THE SYSTEM DISK IN DK2: AND START IT UP (WRITE 
ENABLED). WE WILL COPY THE TASKS DIRECTLY TO THE SYSTEM DISK. 


~e tO 


* IS THE SYSTEM DISK READY? [Y/N]: 


This question is repeated until the disk is’ ready 
response). When ready, the disk is mounted. 


MOU DK2:SYSTEM 
* WAS THE SYSTEM DISK MOUNTED SUCCESSFULLY? [Y/N]: 


If not, the MOU command is issued again. 


e@ %e MO 


NOW WE BUILD THE REQUESTED UTILITY TASKS 


‘ 

ASN LP:=MP: 

ASN TT:=MP: 
ASN NL:=MP: 
SET /UIC=[1,20] 


The selected utility tasks are now built. 


(Y 
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If using the RLO1 or the dual RKOS kit, the build files are 
copied to your secondary storage device and the old versions 
are deleted. Depending on your secondary storage device, 
either PIP or FLX is used to accomplish this (PIP for DL:, 
DK:, or DX: as secondary storage and FLX for CT:, DT:, MM:, 
MT: as secondary storage). The appropriate command is 
issued following the task builder directive. The following 
is an example of the display for a dual RKO5 SYSGEN using an 
RKO5 (DK:) for secondary storage. 


TKB @[1,2x] MACBLD 

PIP DK: [1,5x]/NV=[1,5x]MAC.TSK 

* WAS MAC COPIED SUCCESSFULLY? [Y/N]: 
PIP [1,5x]MAC.TSK;0/DE 


For brevity, the PIP and/or FLX commands, which appear only 
if you are using an RLO1 kit or the dual RKOS kit, are 
omitted here. 


Note that all commands are suppressed for a specific task if 
that task was not selected to be rebuilt. The following 
displays all of the tasks. 


Similar commands are issued to build each of the _ selected 
utility tasks. In some cases, the old versions are purged 
(PIP.../PU), leaving the most recent version, instead of 
being deleted (PIP.../DE). The reason for this is to keep 
tasks that may be required at later stages during SYSGEN. 


1,2x]MACBLD 


1,2x] BIGMACBLD 


1,2x]TKBBLD 


1,2x]BIGTKBBLD 


el 

@[ 

@[ 

el 

@[1,2x]PIPBLD 
@[{1,2x]FLXBLD 
@[1,2x]VFYBLD 
@[(1,2x] DMPBLD 
@[1,2x] EDIBLD 
@(1,2x]SLPBLD 
@{1,2x] LBRBLD 
@[{1,2x] PSEBLD 
@[1,2s]SYEBLD 
@{1,2x]CRFBLD 
@(1,2x]ZAPBLD 
@{1,2x]BADBLD 
@(1,2x] VMRBLD 
@[1,2x] PATBLD 
@[{1,2x]CDABLD 
@[1,2x]CMPBLD 
@[{1,2x]FTBBLD 
@[1,2x]DSCBLD 
@[1,2x]SRDBLD 
@[{1,2x]EDTBLD 
el 
@[ 
@[ 
@[ 
el 
@[ 
@[ 


1,2x]RMSBCKBLD 
1,2x] RMSCNVBLD 
1,2x] RMSDEFBLD 
1,2x] RMSDFNBLD 
1,2x] RMSDSPBLD 
1,2x]RMSRTIBLD 


1,2x]VTECBLD 


The task-builds are complete. 


ltt. 


me Te Te Se TO Ge We 
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If user mode diagnostics were to be built, control passes to 
the indirect command file BLDUMD.CMD (see Section 9.2). The 
task image files that have been built (utilities and/or user 
mode diagnostics) will now be transferred to secondary 
storage. 


WE WILL PAUSE NOW TO ALLOW YOU TO COPY 
~- ANY FILES THAT WERE NOT SUCCESSFULLY TRANSFERRED 
- THE DIAGNOSTIC TASKS 

WHEN THE DIAGNOSTIC TASKS HAVE BEEN COPIED, YOU 

MAY DELETE THEM FROM THIS DISK. 

WHEN DONE, RESUME AT. AS SHOWN BELOW. 


If only user mode diagnostics were selected to be built and 
no utility task, an example of how to do the transfers is 
displayed like the one below. 


(PUT A BLANK MEDIUM IN MTO:) 

>REM PIP 

>INS [1,54] FLX;-1 

>FLX MT0O:/ZE 

>FLX MTO:/DO=RK05.TSK/RS ,TSO3.TSK,TERM.TSK 
RES ...-AT. 


AT. -- PAUSING. TO CONTINUE TYPE "RES ...AT." 


DMO DXO: 
UNL DX0: 


=e Se TO NO TO 


me te Te Te Te Te Te Te Te Be VS Te Te WE 


>MOU DXu: TASKX 


At this time, you may manually copy any files that were not 
successfully transferred by the previous commands, and/or 
the user mode diagnostics if they were selected to be built. 


The secondary storage is dismounted and the driver unloaded. 


If you have a dual-RKO5 system, the task image files are now 
resident on the target system disk. Otherwise, the 
following section of text is displayed to guide you in 
transferring the task image files to the target system disk. 


TO COPY THE TASK IMAGE FILES FROM THE SECONDARY 
STORAGE MEDIUM TO THE SYSTEM DISK, PROCEED AS FOLLOWS 
AFTER SYSGEN3 HAS TERMINATED: 


If your secondary storage is DX, the following example is 
displayed (u is replaced by the actual unit number): 


(BOOT THE SYSTEM DISK) 
>SET /UIC=[(1,5x] 

>INS PIP 

>LOA DX: 


REPEAT FROM HERE... 
REPLACE "TASKX" BY 
ACTUAL VOLUME LABEL 


a ae) 


>PIP =DXu:*.* 


>DMO DXu: ! ...TO HERE FOR ALL VOLUMES 
! USED FOR TRANSFER 

>UNL DX: 

>REM PIP 
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If your secondary storage is MT, MM, CT or DT, the following 
example is displayed (dd is replaced by the actual device 
mnemonic, and u is replaced by the actual unit number): Fa 9 


(BOOT THE SYSTEM DISK) 
>SET /UIC=[1,5x] 

>INS FLX 

>LOA dd: 


! REPEAT FROM HERE... 
>FLX =ddu:*.* 
! ...-TO HERE FOR ALL VOLUMES 
{ USED FOR TRANSFER 
>UNL dd: « 
>REM FLX 
>INS PIP;-1 
>@MTSKCO ! MAKE TASK FILES CONTIGUOUS 
! A SERIES OF PIP COMMANDS FOLLOW 
>@ <EOF> 
>PIP MTSKCO.CMD;0/DE 
>REM PIP 


me TO-Te Me We Te We Te We Ve We. Ts WO Ne Woe WO We 


c 

REM FLX 
REM INI 
REM UFD 
REM PIP 


***USER MODE DIAGNOSTICS*** 


Due to space limitations and the physical locations of files 
on the RKO5 distribution kits, the user mode diagnostics are 
built in slightly differing ways. Read the section 
pertinent to your distribution kit. a 


SET /UIC=[1,20] 
**RLO1l Kits** 


NOW WE BUILD AND COPY THE TASK TO THE SECONDARY 
STORAGE MEDIUM. 
DEPENDING ON THE SECONDARY STORAGE MEDIUM AND THE NUMBER 
OF TASKS TO BE COPIED, YOU MAY HAVE TO MOUNT A BLANK MEDIUM 
IN THE DRIVE AFTER COPYING A TASK. THE RECOMMENDED NUMBER OF FILES 
PER MEDIUM IS: 
RKO5,RLO1 AND MAGTAPE (TSO03,TU10,TU16,TU45) - ALL TASKS WILL FIT 
FLOPPY DISK AND DECTAPE - 4 TASKS PER DISK OR TAPE 
CASSETTE - 1 TASK PER CASSETTE 


IF YOUR SECONDARY STORAGE IS OTHER THAN RKO5, RLO1 OR MAGTAPE, 
AFTER COPYING A TASK, YOU WILL BE ASKED IF YOU WISH TO MOUNT 
A NEW MEDIUM. IF SO THE INDIRECT FILE PROCESSOR WILL 

PAUSE TO ALLOW TIME TO MOUNT IT. 


THE FOLLOWING ARE LEGAL SECONDARY STORAGE DEVICES: 


me Te Me we We We Te VS We Te We MWS Ne Te We WS Ne Ne We WSO Te WS Be 


DK (RKO5 DISK, FOR RKO5 DISTRIBUTION KITS ONLY) 

DL (RLO1 DISK, FOR RLO1 DISTRIBUTION KITS ONLY) 

DX .(RXO1 FLOPPY DISK) 

cT (TU60 CASSETTE TAPE) 

DT (TU56 DECTAPE) . 
MT (TSO3, TE10, OR TU1O MAGTAPE) 

MM (TU1L6, TE16, OR TU45 MAGTAPE) 
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* ENTER DEVICE FOR SECONDARY STORAGE [DDU] [S]: 


The next query displayed is dependent on your’ secondary 
Storage device. 


*DK: or DL: as Secondary Storage Device* 


The following assumes DK: was entered as the _ secondary 
storage device. 


+ PUT YOUR TARGET SYSTEM DISK IN DK: 
* IS DK: READY? [Y/N]: 


This query is repeated until the device is ready (Y 
response). 


* ENTER VOLUME LABEL OF DK: {S]: 
The device is then mounted using this volume label. 
MOU DK:volume label 


Control then passes to the indirect command file BLDUMD.CMD 
(see that Section). 


*DX: aS Secondary Storage Device* 
If DX: is not loaded, the MCR LOA command is issued. 
LOA DX: 
TO COPY THE TASK IMAGE FILES FROM THE SECONDARY 


STORAGE MEDIUM TO THE SYSTEM DISK, PROCEED AS FOLLOWS 
AFTER SYSGEN3 HAS TERMINATED: 


(BOOT THE SYSTEM DISK) 
>SET /UIC = [1,5x] 


>INS SPIP 
>LOA DX: 
{REPEAT FROM HERE... 
>MOU DX: TASKX ! REPLACE "TASKX" BY 
! ACTUAL VOLUME LABEL 


>PIP = DX:*,* 

>DMO DX: 
!...TO HERE FOR ALL VOLUMES 
{USED FOR TRANSFER 

>UNL DX: 


me te TO Me Te Te TO We Te WS Ne Te WH NS WS We Ne We 


Control then passes to the indirect command file BLDUMD.CMD 
(see Section 9.2). 


*CT:, DT:, MT:, or MM: as Secondary Storage Device* 


The following assumes DT: was entered as the secondary 
storage device. 


If the secondary storage device is not loaded, the MCR LOA 
command is issued. 


LOA DT: 


me ™e we TO TO Te TS We We WH Wo We We 


=e 


me wo 


+ 
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TO COPY THE TASK IMAGE FILES FROM THE SECONDARY 
STORAGE MEDIUM TO THE SYSTEM DISK, PROCEED AS FOLLOWS 
AFTER SYSGEN3 HAS TERMINATED: 


(BOOT THE SYSTEM DISK) 

>SET /UIC = [1,5x] 

>INS SFLX 

>LOA DT: 
! REPEAT FROM HERE... 

>FLX = DT:*.* 
! ... TO HERE FOR ALL VOLUMES 
! USED FOR TRANSFER 

>UNL DT: 


>REM FLX 


Control then passes to the indirect command file BLDUMD.CMD 
(see Section xxx). 


**Dual RKO5 Kits** 


DO YOU HAVE AN EMPTY RKO5 REMOVABLE DRIVE AVAILABLE? [Y/N]: 


If not, instructions are given for copying the task image 
files from secondary storage to the system disk. 


If an empty drive is available, you are asked to _ identify 
the unit number. 


WHAT IS THE UNIT NUMBER OF THE EMPTY DRIVE? [0 R:0-3]: 


The following assumes that DK2: is the empty drive. 


PLACE THE SYSTEM DISK IN DK2: AND START IT UP (WRITE 
ENABLED). WE WILL COPY THE TASKS DIRECTLY TO THE SYSTEM DISK. 


IS THE SYSTEM DISK READY? [Y/N]: 


‘This question is repeated until the disk is ready (Y 
response). When ready, the disk is mounted. 


MOU DK2:SYSTEM 


* WAS THE SYSTEM DISK MOUNTED SUCCESSFULLY? [Y/N]: 


If not, the MOUnt command is issued again. 


If mounted successfully, control passes to the indirect 
command file BLDUMD.CMD (see Section 9.2). 


**A11 Kits Except RLO1 Kit and RKOS Kits** 


Control is passed directly to the indirect command file 
BLDUMD.CMD (see Section 9.2). 


End of SYSGEN Phase III. 


mae 
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9.2 BLDUMD.CMD FILE DETAILS 
BLDUMD is the indirect command file to task-build all or selected User 
Mode Diagnostics. BLDUMD is called from SYSGEN Phase III if the 
corresponding question is answered appropriately. It may also be 
called manually at any time with the following command: 

>@ [200,200] BLDUMD 


The following is a detailed description of all the steps in BLDUMD. 


BLDUMD <VERSION 03.1> 


COPYRIGHT (C) 1976, 1977, 1979 
DIGITAL EQUIPMENT CORP., MAYNARD, MASS. 01754 


BUILD ALL OR SELECTED USER MODE DIAGNOSTICS. 


ARE YOU RUNNING ON A MACHINE WITH AT LEAST 24K WORDS? [Y/N]: 


mo 6g te Ne Me Me Ms Me TO NO NO 


If the answer is N, the following text is displayed and 
BLDUMD terminates. 


=o 


SORRY, YOU CANNOT BUILD (OR RUN) THE USER MODE DIAGNOSTICS 
ON A MACHINE WITH LESS THAN 24 K WORDS! 


™—e 


=e TO 


Otherwise, processing continues here, 


As in the previous sections of SYSGEN, you must identify 
your distribution kit. 


* DO YOU HAVE THE DUAL RKO5 DISTRIBUTION KIT? [Y/N]: 
If you do, you are asked to identify the RKO5 drives’ that 
contain the UTLOBJ and RSXM26 disks. The UTLOBJ disk is 
then assigned to SY: and the RSXM26 disk is assigned to 
LB:. 

* IN WHICH RKO5 DRIVE IS THE UTLOBJ DISK MOUNTED? [O R:0-3]: 

* IN WHICH RKO5 DRIVE IS THE BASLINE DISK MOUNTED? [O R:0-3]: 


The following assumes DKO: for the UTLOBJ disk and DkKl1: 
for the RSXM26 disk. 


ASN DKO:=SY: 
ASN DK1:=LB: 


If you replied negatively to the dual RKO5 query, the next 
query displayed is 


* IS THE CURRENT SYSTEM DISK AN RP02/03/04/05/05 OR RKO06/07? 
* DO YOU WANT EXPANDED COMMENTS FOR THE UMD BUILD PROCEDURE? [Y/N]: 


Expanded comments provide a lot of descriptive text that the 
experienced user might want to dispense with. 


* ee me TO Me we TS Te Te TS We We WS We We Be We We Te Ns Me WE Te We We Ve We 
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DIAGNOSTIC TASKS CAN BE BUILT FOR THE FOLLOWING DEVICES: 


MNEMONIC DEVICE DIAGNOSTIC NAME 
DB: RJP04/RWPO04 RP04 
DB: RJPO5/RWPO5 RPO5 
DB: RJ PO6/RWP06 RP06 
DF: RF11/RS11 RF11 
DK: RK11/RK05 RKO5 
DM: RK611/RK06 RK0O6 
DM RK611/RK07 RKO7 
DP: RP11/RP02 RPO2 
DP: RP11/RP03 RP03 
DP: RP11E/RPRO2 RPRO2 
DS: RJSO3/RWS03 RS03 
DS: RJS04/RWS04 RSO04 
DT: TC11/TU56 TU56 
MM: TJU16/TWU16 TU16 
MM: TJIU16/TWU45 TU45 
MT: TMA11/TU10 TU10 
MT: TMA11/TS03 TSO3 
TTs TERMINAL TERM 
DRIVE 


COMPATIBILITY COMP 
DO YOU WANT DIAGNOSTICS FOR A MAPPED SYSTEM? [Y/N]: 
IS THE TARGET SYSTEM AN 11/70 [Y/N]: 


i 
SET UIC=[(1,2x] 


me te Me TO Ne Te We We We 


+ 


If you are using other than a dual RKO5 distribution kit, 
the task image files will be generated on the system disk, 
and the next section is bypassed. 


THE DIAGNOSTIC TASKS WILL BE STORED ON THE SYSTEM DISK BY DEFAULT. 
IF YOUR SYSTEM DISK IS AN RKO5 YOU MAY BE REQUIRED TO STORE THE 
DIAGNOSTICS ON A SEPARATE DISK TO AVOID ALLOCATION PROBLEMS. 


IF YOU HAVE THE DUAL RKO5 RELEASE KIT, YOU SHOULD SPECIFY 

THAT THE DIAGNOSTICS BE STORED ON ANOTHER DISK. IF YOU HAVE 

A THIRD RKO5 PUT THE PRIVOBJ DISK IN IT AND STORE THE DIAGNOSTICS 
ON IT. OTHERWISE, STORE THEM ON LBO:. 


DO YOU WANT THE DIAGNOSTICS STORED ON ANOTHER DISK? [Y/N:] 
If this question is answered with an N, the next section is 
bypassed. Otherwise, you are asked for the device mnemonic 
and unit number of the disk where to store the diagnostics. 


ENTER THE OUTPUT DEVICE NAME AND UNIT NUMBER (E.G. DK1) [S]: 


It is assumed in the following lines that you answered this 
question with DKl. 


 ~e we te TO NO NO 


me %S TO MO TO Ne 


me we “eo TO TS Vs TS 


aT) =e 


+ & 
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THE COMMAND BUILD FILE WILL NOW PAUSE WHILE YOU MOUNT DK1: 
YOU MUST CREATE THE UFD'S [1,3x] AND [1,5x] ON THE DISK 
(THE FORMER ONLY IF YOU WANT THE TASK BUILD MAPS) IF THEY 
DO NOT ALREADY EXIST. 


EXAMPLE: 
>INIT DK1:DIAGNOSTICS 
>MOUNT DK1:DIAGNOSTICS 
>UFD DK1: [1,3x] 
>UFD DK1:[1,5x] 


AT. -~ PAUSING. TO RESUME TYPE "RES ...AT." 


Whatever the system disk type is, processing continues here. 


DIAGNOSTICS ARE GENERALLY RUN WITH THE FOLLOWING ATTRIBUTES: 


PARTITION = GEN 
BASE ADDRESS = 40000 
SIZE = 40000 


The last two lines appear only if you are building 
diagnostics for an unmapped system. 


IF YOUR SYSTEM IS DIFFERENT ANSWER YES TO THE FOLLOWING QUESTION. 
DO YOU WANT TO ALTER THE DEFAULT PARTITION ATTRIBUTES? [Y/N]: 


The following three questions are bypassed if you answered 
this question with anN. 


ENTER THE PARTITION NAME (DEFAULT=GEN) [S]: 


The following question is asked only if you are building 
diagnostics for an unmapped system. 


ENTER THE PARTITION BASE ADDRESS (DEFAULT=40000) [S]: 
ENTER THE PARTITION SIZE (DEFAULT=40000) [S]: 


THE DIAGNOSTIC TASKS ARE NORMALLY BUILT TO TRANSFER DATA VIA 
A 2000 OCTAL BYTE DATA BUFFER. YOU MAY SPECIFY A DIFFERENT 
BUFFER SIZE BY ANSWERING THE NEXT QUESTION. 


ENTER THE BUFFER SIZE IN OCTAL BYTES (DEFAULT=2000) [S]: 


NORMALLY DIAGNOSTIC TASK BUILD MAPS ARE NOT REQUIRED. 
IN THE UNLIKELY EVENT YOU NEED THEM, ANSWER "YES" TO THE 
FOLLOWING QUESTION. 


DO YOU WANT TASK BUILD MAPS? [Y/N]: 
DO YOU WANT THE MAPS LISTED ON THE LINEPRINTER? [Y/N]: 


If you answered Y to the first question and N to the’ second 
of the two questions above, the maps will be directed to UFD 
[1,3x] on the output disk. 
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NORMALLY YOU ENTER EACH DIAGNOSTIC NAME REQUIRED FOR YOUR SYSTEM. 
AN ALTERNATE METHOD IS PROVIDED WHICH ALLOWS BUILDING ALL 
AVAILABLE DIAGNOSTICS. THIS METHOD REQUIRES ABOUT 500 BLOCKS OF 
DISK SPACE ON THE OUTPUT DEVICE. THE DIAGNOSTICS THAT DO NOT APPLY 
CAN BE DELETED AT A LATER TIME. 


DO YOU WANT TO BUILD ALL AVAILABLE DIAGNOSTICS? [Y/N]: 
HAVE ALL QUESTIONS BEEN ANSWERED TO YOUR SATISFACTION? [Y/N]: 


* Hse Te TO Ne me te te 


If you answered these questions with N, processing will 
restart at the beginning of BLDUMD. Otherwise, if you want 
to build all diagnostics, the next section that asks_ for 
diagnostic names is bypassed. 


ENTER THE NAME OF THE DIAGNOSTIC TASKS TO BUILD, ONE AT 
A TIME. WHEN DONE, ENTER A SINGLE CARRIAGE RETURN. 


THE FOLLOWING IS A LIST OF VALID DIAGNOSTIC NAMES: 
RP04,RP05,RP06,RF11,RK05,RK06,RP02,RP03,RPRO2,RS03 
RSO04,TU56,TU16,TU45,TU10,TS03,TERM 


HERE IS A SAMPLE DIALOGUE TO BUILD THE RJPO04/RWP04 DISK AND THE 
TMA11/TSO3 MAGTAPE DIAGNOSTICS ( <CR> = CARRIAGE RETURN) : 


NAME [S] :RP04<CR> 
NAME [S]:TSO3<CR> 
NAME [S]:<CR> 


me Me Me TSO TO Te Ne TE uy TS Te Te Se Ne Ve 


The next question requires as a response, the name of the 
next diagnostic to build, out of the list shown above. 


* NAME [S]: 


If an invalid name is entered (for example "XX"), the 
following message is displayed, and the question is 
repeated. 


; eee "XX" DIAGNOSTIC IS NOT AVAILABLE***** 


The question "* NAME [S]:" is repeated to allow you to enter 
the names of all diagnostics to be built. When done, answer 
with a single carriage return. 


If you chose to build all the diagnostics, or when you have 
entered the names of all the desired diagnostics, processing 
continues here. 


; 
7 NOW WE TASK BUILD THE SELECTED DIAGNOSTICS 


o 
INS $BIGTKB 
TKB @UMDBLD 


The command above builds the selected diagnostics, according 
to specifications defined by the previous sections. 


REM TKB 


End of UMDBLD. 


>e[ 


>* 
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The following sample dialogue builds diagnostics for RKO5, 
TU16, and terminals to run on an unmapped system. The GEN 
partition in that system starts at 50000. The task image 
files are directed to the target system disk which is put in 


drive DKl:. 
200,200] BLDUMD 
BLDUMD <VERSION 03.1> 


COPYRIGHT (C) 1976, 1977, 1979 
DIGITAL EQUIPMENT CORP., MAYNARD, MASS. 01754 


BUILD ALL OR SELECTED USER MODE DIAGNOSTICS. 


ARE YOU RUNNING ON A MACHINE WITH AT LEAST 24K WORDS? [Y/N] :Y 

DO YOU HAVE THE DUAL RKO5 DISTRIBUTION KIT? [Y/N]: 

IS THE CURRENT SYSTEM DISK AN RP02/03/04/05/06 OR RKO6? [Y/N]: Y 
DO YOU WANT EXPANDED COMMENTS FOR THE UMD BUILD PROCEDURE? [Y/N]: 
DO YOU WANT DIAGNOSTICS FOR A MAPPED SYSTEM? [Y/N]: 


>SET /UIC=[1,20] 


DO YOU WANT THE DIAGNOSTICS STORED ON ANOTHER DISK? [Y/N] :Y 
ENTER THE OUTPUT DEVICE NAME AND UNIT NUMBER (E.G. DK1) [S]: DKl 


THE COMMAND BUILD FILE WILL NOW PAUSE WHILE YOU MOUNT DKl: 
YOU MUST CREATE THE UFD'S [1,30] AND [1,50] ON THE DISK 
(THE FORMER ONLY IF YOU WANT THE TASK BUILD MAPS) IF THEY 
DO NOT ALREADY EXIST. 


-- PAUSING. TO CONTINUE TYPE "RES ...AT" 


>MOU DK1:UNMOBJ 
>RES ...AT 


AT. 


-- CONTINUING 


DO YOU WANT TO ALTER THE DEFAULT PARTITION ATTRIBUTES? [Y/N] :Y 
ENTER THE PARTITION NAME (DEFAULT=GEN) [S]: 

ENTER THE PARTITION BASE ADDRESS (DEFAULT=40000) [S]: 50000 
ENTER THE PARTITION SIZE (DEFAULT=40000) [S]: 

ENTER THE BUFFER SIZE IN OCTAL BYTES (DEFAULT=2000) [S]: 

DO YOU WANT TASK BUILD MAPS? [Y/N]: 

DO YOU WANT TO BUILD ALL AVAILABLE DIAGNOSTICS? [Y/N]: 

HAVE ALL QUESTIONS BEEN ANSWERED TO YOUR SATISFACTION? [Y/N] :Y 


ENTER THE NAME OF THE DIAGNOSTIC TASKS TO BUILD, ONE AT 
A TIME. WHEN DONE, ENTER A SINGLE CARRIAGE RETURN. 


NAME [S]: RKO5 
NAME [S]: TU16 
NAME [S]: TERM 
NAME [S]: 


NOW WE TASK BUILD THE SELECTED DIAGNOSTICS 


>TKB @UMDBLD 


>} 
>@ 
> 


<EOF> 


CHAPTER 10 


INSTALLATION VERIFICATION PROCEDURE 


10.1 INTRODUCTION 


The RSX-11M Installation Verification Procedure checks out the 
software-hardware system that you created during the SYSGEN process. 
The procedure does not replace the hardware diagnostics that DIGITAL 
Field Service runs’ on individual devices nor does it substitute for 
software testing during software development. The procedure merely 
verifies that your generated system has produced a working system with 
the configuration that you requested during SYSGEN. 


The Installation Verification Procedure consists of a set of 
controlling command files that run a series of test modules that gives 
the system a rigorous exercising. The procedure exercises two areas 
of the system: hardware, discussed in Section 10.2 and software, 
discussed in Section 10.3. 


10.2 HARDWARE 


As a result of running this procedure, you know what devices were 
successfully generated into the system and you have verified the 
functioning of all disk and tape units under operating system control. 
The procedure operates the devices under varying system loads. 


10.2.1 System I/O Exerciser 


The system I/O exerciser verifies the functioning of all disk and tape 
units on the system and identifies all devices to be tested. The 
exerciser tests disks as Files-1ll volumes (mounted automatically) that 
are public or not allocated by another user. Also, the exerciser 
tests DECtape, cassettes, and magtape by using AST driven QIO 
requests. 


After the test, the exerciser deletes all files that it has created on 
these volumes. However, the exerciser does not modify the disk 
Structure or any existing disk data. Be aware that the exerciser 
overwrites tapes and destroys their contents. 


10.3 SOFTWARE 


The software verification modules of the procedure quickly access and 
exercise those discrete system software components that can be 
operated under command file control. This operation tests’ the 
completeness of the System Generation procedure. 


10-1 


INSTALLATION VERIFICATION PROCEDURE 


10.3.1 CPU-bound Load Test 


The €PU-bound load test determines whether the system can handle a 
heavy loading of parallel processing, compute-bound tasks. This test 
determines whether the entire memory encompassed by the- system 
partition, GEN, is available to the system. This test uses the 
checkpointing, swapping, and round-robin scheduling Executive options 
when present. Also, this test uses the Send and Receive Executive 
directives. This test cannot be run in an unmapped system and 
therefore is skipped in an unmapped system. 


10.3.2 System Utilities Verification 

This test invokes most of the standard RSX-11M system utilities and 
verifies their presence and operation by using an indirect command 
file routine. The test invokes interactive editors and the ACNT 
program to demonstrate that an executable task file exists. You can 


choose to execute some functions in these programs or exit from them 
immediately. 


10.4 OPERATING PROCEDURES 
Your system must meet certain configuration and operational 


requirements to run the entire Installation Verification Procedure. 
These requirements follow. 


10.4.1 Configuration Restrictions 
e The hardware verification section requires that the system 
support ASTs,. The I/O exerciser and CPU-bound load test use 
ASTs. 


e If the system is unmapped, the procedure does not execute the 
CPU-bound load test. 


If your system does not support any of the following features, the 
CPU-bound load test cannot run. However, the procedure determines 
whether your system supports the following features. It does not run 
the CPU-bound test if any are missing. 
The required features for the CPU-bound load test are: 

e Send/Receive directives 

e Alter Priority directive 

e Get Partition Parameters directive 


e AST support 


e Dynamic checkpointing 
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Operating Environment 


Run the Installation Verification Procedure following the 


completion of SYSGEN. The devices to be tested cannot be 
allocated to other users. 


You should run the Installation Verification Procedure on a 
Stand-alone basis if possible. The procedure puts a heavy 
load on the system to the detriment of the throughput of other 
system users. The procedure should have an unlimited access 
to system features and devices to properly do its assigned 
task. 


You must run the procedure from a privileged terminal. 


The procedure runs from UIC [2,300]. If you wish, you’ can 
delete the entire contents of [2,300] after a successful run. 


You must place scratch tapes on all magnetic tape drives, 
including cassettes and DECtapes. Files-1ll initialized disks 
must be placed on all disk drives. 


The procedure can be repeated without the necessity of 
rebuilding DEFINE.TSK if DEFINE is installed. 


The procedure needs only one terminal to run. If a second, 
CRT terminal exists, you can use it to run RMDEMO. If one 
terminal is a printing terminal, use it to run the _ procedure 
to allow you to check the printout for errors. If you must 
run the procedure from a CRT terminal, you must watch’ the 
terminal very closely to avoid missing important information 
(for example, error messages) that you may need later. 


Operating Instructions 


Boot the system. 
Allocate a large checkpoint space for the system. 
Place scratch media on all DECtape, cassette and magtape 
drives. Place initialized disk packs on all empty drives. 
The packs need not be scratch packs because data is not lost 
on them. 
Execute the command file, SAM. For example: 

>@[2,300] SAM 
From this point, the operating instructions are part of the 
console dialogue, which follows in Section 10.4.4, "Sample 
Console Dialogue". When the procedure runs to completion, 


examine the dialogue for error messages. These fall into 
three categories: 


a. A function did not execute because this system 
intentionally does not contain the function. 


b. A function did not execute because of a SYSGEN error. 


c. A hardware problem occurred. 
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10.4.4 Sample Console Dialogue 


The following console dialogue is from an actual session of running 
the RSX-11M Installation Verification Procedure. It is included here 
to guide you and give you an indication of what to expect when you run 
your procedure. Before you begin, mount the Executive source disk 
(EXCSRC) and assign it to SY:. 


>SET /UIC=[2,300] 
>MOU DLO:/OVR 
>PIP =DLO:SAM.CMD 


KRREKKEKKEEEKEEKEKRKEKEEKKERKEEKREKEKEEKEKKEKKKEKEKKRKEKRKRKRKKKKKES 


>@SAM 

: KKK KEKE REE EERE REREKEREREREEEKEKEKEKKK KE 
‘ * * 
’ 

; = RSX-11M INSTALLATION VERIFICATION PROCEDURE * 
° * * 
‘ 

i 

>: 


t 

>SET /UIC=[2,300] 
>INS LB:SPIP 
>RUN ERRLOG 


ERL -- ERROR LOG INITIALIZED 

>; 

>* DO YOU WISH TO RUN RMDEMO? [Y/N]: N 

ERL -- ERROR LOG INITIALIZED 

>} 

>* ENTER UNIT NUMBER OF TERMINAL [S]: 0 
; 

>; 

>; 

>; 

>; kAkKEK NOTE **** 

>; 


>; TEST MEDIA MUST BE LOADED ON ALL TAPE AND DISK DRIVES. USE SCRATCH 
>; TAPES AND FILES-11 FORMAT DISKS. 


>; ALL MAGTAPES BEING TESTED ARE OVER-WRITTEN. THE DISKS ARE 
>; TESTED WITH FILE-STRUCTURED I/O WITH NO NEGATIVE EFFECT ON DATA 
>; OR STRUCTURE. 


>; BEFORE PERFORMING THE FILE-STRUCTURED I/O TEST, ALL UNMOUNTED 
>; DISKS ARE MOUNTED AUTOMATICALLY. 
>* DO YOU NEED TO INITIALIZE ANY DISKS? [Y/N]: N 


>TIM 
12:57:52 06-FEB-79 


>; NEEDED UTILITIES WILL BE INSTALLED NOW. 
Dp RARKKKAREK 


>; RREEKKEKEKEKREEEEKEKEKRKEEKKERAEKREKRKEKREKREKKEKREKEKRKEKKKEKEEKKKKKKKKKRKKKKES 


>PIP TAILOR.DAT=DEVM.SAM/AP 

>MAC DEFINE=[11,10] RSXMC/PA:1,[2,300] DEFINE 

>TKB DEFINE/PR/CP=DEFINE,LB: [1,54] RSX11M.STB, [1,1] EXELIB/LB 
>INS DEFINE/TASK=DEFINE 

>PIP *.*/PU 

>RUN DEFINE 


>} * CPU-BOUND LOAD TEST * 
>INS DUMMY/TASK=DUM00/PRI=40. 


>INS LOGGER/TASK=LOG00 
>INS QTRUN /TASK=QTROO 
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>RUN DUMOO 
¢ 

7 FOR THE NEXT FEW MINUTES A NUMBER OF COMPUTE BOUND TASKS WILL BE 
3; EXERCISING THE MEMORY, THE MULTI-TASKING CAPABILITIES OF THE 
+ SYSTEM AND, IF INCLUDED IN THIS SYSTEM, THE ROUND-ROBIN SCHEDULER, 
+ THE SHUFFLER, AND CHECKPOINTING. THE ACTION OF THESE LAST THREE 
; FEATURES CAN BE SEEN ON THE RMDEMO SCREEN. IF THE SYSTEM IS 
; PERFORMING PROPERLY, ALL OF THE "GEN" IS USED AND THE "QT" 
; TASKS ARE SHARING THE SYSTEM RESOURCES IN A MANNER CONSISTENT 

>; WITH THE FEATURES AVAILABLE. NOTE THAT CHECKPOINTING IS DISABLED 
3; FOR THE SECOND HALF OF THE TEST. 


>; *k* THIS TEST RUNS FOR A MAXIMUM OF 6 MINUTES *** 
; 

>RUN QTROO 

> 

>TIM 


12:59:51 06-FEB-79 

>INS NUL3/TASK=QT0000 
>INS NUL3/TASK=QT0100 
>INS NUL3/TASK=QT0 200 
>INS NUL3/TASK=QTO0 300 
>INS NUL3/TASK-QTO 400 
>INS NUL3/TASK=QT0 500 

a: 2>>>>> THE LOAD TEST IS RUNNING <<<<<< 


>TIM 

13:06:15 06-FEB-79 
>REM QTOO000 

>REM QTO0100 

>REM QT0200 

>REM QT0300 

>REM QT0400 

>REM QTO0500 


>; * TEST COMPLETED * 
i 
>; 
>; 
; * SYSTEM I/O EXERCISER * 


; THE FOLLOWING DEVICES HAVE BEEN GENERATED INTO YOUR SYSTEM. THOSE 
>; LISTED AS "OFFLINE" ARE NOT PHYSICALLY PRESENT AND ARE NOT 

; TESTED. INDIVIDUAL MAG TAPE, DEC TAPE AND RKOS5 UNITS 

; CAN BE SHOWN ERRONEOUSLY AS ONLINE WHEN THE CONTROLLER IS ONLINE. 
>; THEY ARE TESTED AND THE TEST FAILS AFTER SEVERAL MINUTES 

; OF ERROR MESSAGES. 


> DEV 

LPO: LOADED 

DBO: OFFLINE LOADED TYPE=RP04 
DB1: LOADED TYPE=RP04 

DB2: OFFLINE LOADED TYPE=RP04 
DB3: MOUNTED LOADED LABEL=RSX26 TYPE=RP04 
DB4: OFFLINE LOADED TYPE=RP04 
DDO: OFFLINE UNLOADED 

DD1: OFFLINE UNLOADED 

DKO: LOADED 

DK1: LOADED 

DLO: OFFLINE UNLOADED TYPE=RLO1 
DL1: OFFLINE UNLOADED TYPE=RLO1 
DMO: OFFLINE LOADED TYPE=RK06 
DM1: LOADED TYPE=RK06 

DPO: UNLOADED TYPE=RP02 
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DPl: 

DRO: 

DR1: 

DSO: 

DSIl: 

DTO: 

DT1l: 

DX0O: 

DX1: 

MMO: 

MM1: 

MTO: 

MT1l: 

MSO: 

TTO: 

TTl: 

TT2: 

TT3:3 

TT4:; 

TT5: 

TT63 

TT7: 

TT10: 
TT1ll: 
TT12: 
TT13: 
TT14: 
TT15: 
TT16: 
TT17: 
TT20: 
TT21: 
TT22: 
TT23: 
TT24:3 
TT253 
TT26: 
TT27: 
TT30: 
TT3l1: 
TT32: 
TT33: 
TT3 4:3 
TT35: 
TT36: 
TT373 
NLO: 

TIO: 

COO: 

CLO: 

LBO: 

SYO: 

WKO: 

>; 

>; 


INSTALLATION VERIFICATION PROCEDURE 


UNLOADED TYPE=RP02 


OFFLINE 


UNLOADED TYPE=RM03 


OFFLINE 
OFFLINE 
OFFLINE 
OFFLINE 
OFFLINE 
OFFLINE 


UNLOADED 
UNLOADED 


OFFLINE 
OFFLINE 
OFFLINE 
[2,300] 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 
LOADED 


TTO: 
TTO: 
DB3: 
DB3: 
DBO: 


UNLOADED TYPE=RM03 


UNLOADED TYPE=RS04 

UNLOADED TYPE=RS03 

LOADED 

LOADED 

LOADED ; 

LOADED ° 


LOADED 

LOADED 

UNLOADED z 
- LOGGED ON LOADED 


>; IF ANY DRIVERS ARE UNLOADED, THEY ARE LOADED NOW. 


>; 


>; KREKKKRKKKKK 


>LOA DP: 
>LOA MM: /PAR=GEN 
INTERRUPT VECTOR ALREADY IN USE 


LOA -- 


>; REKEKEKEKEKEKEKKKEEEKREKREREREKKEEKEKREKKKEKKEAKKKRKKKKKAK KKK 


>INS [2,300] IOX/TASK=...SI10 
>MOU DB1:/0VR/VI 
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MOUNT-**VOLUME INFORMATION** 


DEVICE 
CLASS 
LABEL 
UIC 
ACCESS 
CHARAC 


] 
>MOU DK1:/OVR/VI 


DB1l: 


FILE 11 
RSX11M 


{1,1] 


[RWED ,RWED ,RWED,RWED] 


MOUNT-** VOLUME INFORMATION** 


DEVICE 
CLASS 
LABEL 
UIC 
ACCESS 
CHARAC 


>MOU DKO:/0VR/VI 


DK1ls: 


FILE 11 


SYSTEM 


[1,1] 


[RWED ,RWED ,RWED ,RWED] 
] 


MOUNT-**VOLUME INFORMATION** 


DEVICE 
CLASS 
LABEL 
UIC 
ACCESS 
CHARAC 


>MOU DM1:/0VR/VI 


DKO: 


FILE ll 


UTIL 


[2,300] 


[RWED ,RWED,RWED,RWED] 


(] 


MOUNT-** VOLUME INFORMATION** 


DEVICE 
CLASS 
LABEL 
UIC 
CLASS 
CHARAC 
>} 


THE 


DM1: 


01 


FILE 11 
RSXM26 
[1,1] 

[RWED ,RWED ,RWED ,RWED] 


13:06:18 06-FEB-79 
>SIO @IOXCNF 
SIO -- DRIVER NOT LOADED 


SYSTEM I/O EXERCISER WILL RUN FOR 3 MINUTES 


SIO -- FAILED TO ATTACH UNIT 
SIO -- SUMMARY OF EXERCISER ACTIVITY AT 6-FEB-79 13:09:39 
TIME -- RUN: 3 MIN. ELAPSED: 3 MIN. REMAINING: 0O MIN. 
DB1: -- 7,053. REQUESTS TOTALING 7,053. BLOCKS WITH NO ERRORS 
DB3: -- 7,052. REQUESTS TOTALING 7,052. BLOCKS WITH NO ERRORS 
DKO: -~- 2,348. REQUESTS TOTALING 2,348. BLOCKS WITH NO ERRORS 
DK1l: -- 2,341. REQUESTS TOTALING 2,341. BLOCKS WITH NO ERRORS 
DM1: -- 6,547. REQUESTS TOTALING 6,547. BLOCKS WITH NO ERRORS 
IDLE-LOOP COUNT: 1,988. ITERATIONS 
ACCUMULATED TOTALS =: 
TIME -- RUN: 3 MIN. ELAPSED: 3 MIN. REMAINING: O MIN. 
DB1: -- 7,053. REQUESTS TOTALING 7,053. BLOCKS WITH NO ERRORS 
DB3: ~- 7,052. REQUESTS TOTALING 7,052. BLOCKS WITH NO ERRORS 
DKO: -- 2,348. REQUESTS TOTALING 2,348. BLOCKS WITH NO ERRORS 
DKl: -- 2,341. REQUESTS TOTALING 2,341. BLOCKS WITH NO ERRORS 
DMl: -- 6,547. REQUESTS TOTALING 6,547. BLOCKS WITH NO ERRORS 
IDLE-LOOP COUNT: 1,988. ITERATIONS 


>REM SIO 


>TIM 


13:10:05 06-FEB-79 
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¢ 
>; * TEST COMPLETED * 


; * UTILITIES VERIFICATION SECTION * 


>; 


; * CMP VERIFICATION * 


13:10:17 O6-FEB-79 
>PIP COMPAR.CMD=SIOE.CMD 
>! INVOKE CMP TO COMPARE IDENTICAL FILES 
>CMP TI:= COMPAR.CMD,SIOE.CMD 
1) COMPAR.CMD;1 
2) SIOE.CMD;1 


NO DIFFERENCES FOUND 
TI:=COMPAR.CMD ,SIOE.CMD 
>! NO DIFFERENCES SHOULD HAVE BEEN FOUND 
>! 
>! INVOKE CMP TO COMPARE DIFFERING FILES 
>CMP TI:FILE1.,FILE2. 
RRKREKKKKKERKEKKERKEEKEKEKKEKEKEEKERKKKKKRKKKKKKKRKKRKKEKE 
1) FILE.;1 
6 .; IF CMP IS FUNCTIONING, THIS LINE FROM FILE1. IS DIFFERENT 
7.7 THE REST OF THE LINES ARE IDENTICAL 
REKKKEKEKEKKKKKEEKE 
2) FILE2.;1 
6 .; THIS LINE IS THE FILE2. LINE WHICH DIFFERS FROM THE ABOVE. 
7 .; THE REST OF THE LINES ARE IDENTICAL. 


1 DIFFERENCES FOUND 
TI:=FILE1.,FILE2. 
>! ONE DIFFERENCE SHOULD HAVE BEEN FOUND 
>PIP COMPAR.CMD; */DE 
>; 
>TIM 
13:10:46 O06-FEB-79 
>} 
>; * CMP VERIFICATION COMPLETE * 
>; 
>; * ALL, BAD, INI, MOU, UFD, VFY, DMO, AND DEA VERIFICATION * 
>; 
>TIM 
13:10:52 O06-FEB-79 
>} 


Vv 
=e 


THIS ROUTINE CHECKS THE DISK-ACCESSING MCR COMMANDS ALL, BAD, INI, 


>; MOU, UFD, VFY, DMO AND DEA. 
>; ALL AND DEA ARE TESTED ONLY FOR A MULTI-USER SYSTEM. 
>; THIS ROUTINE REQUIRES EITHER ONE DISK DRIVE (OTHER THAN SY:) OR 
>; DECTAPE OR ANSI SUPPORT FOR MAGTAPE. IT WILL NOT USE A PUBLIC 
>; DISK. IF ONLY MAGTAPE IS AVAILABLE, A SUB-SET OF THE TEST IS RUN. 
>7 
>; 
>INS SBAD 
>3 
; 
>DMO DKO: 
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>DEA DKO: 
*** DKO: -- DISMOUNT COMPLETE 


>; *** BE SURE THERE IS A SCRATCH MEDIUM ON DKO: *** 
>* DO YOU WISH TO CONTINUE WITH THIS MODULE ? [Y/N]: Y 


>INS S$VFY/TASK=...VFY 

>ALL DKO: 

>BAD DKO: 

BAD -- DKO: TOTAL BAD BLOCKS= 0. 
>INI DKO:UTIL/BAD= [AUTO] /UIC=[2,300] 
>MOU DKO:UTIL/VI 

MOUNT ** VOLUME INFORMATION ** 


DEVICE = DKO: 

CLASS = FILES 11 

LABEL = UTIL 

UIC = [2,300] 

ACCESS = [RWED,RWED,RWED,RWED] 
CHAR = {[] 


>UFD DKO: [2,300] 
>PIP DKO:=DISK.CMD 
>VFY DKO:/FR 


DKO: HAS 4634. BLOCKS FREE, 166. BLOCKS USED OUT OF 4800. 
>DMO DKO: 
7 


**k* DKO: -- DISMOUNT COMPLETE 

>; 

>DEA DKO: 

>; 

TIM 

13:12:42 O06—-FEB-79 

>REM VFY 

>REM BAD 

>; 
: * ALL, BAD, INI, MOU, UFD, VFY, DMO, AND DEA * 
: * VERIFICATION COMPLETE * 
; 
; * FLX VERIFICATION * 

>; 

7 

>INS [1,54] FLX/TASK=...FLX 

3 


>; THE FOLLOWING QUESTION WILL BE ANSWERED: DOES FILEX FUNCTION? 


>; THE TAPE ON DRIVE MMO: WILL BE OVER WRITTEN. 


>? 

>FLX MM:/ZE 

FLX -- DEVICE HANDLER MISSING 
>FLX MM:/DO=FI.LEX ,FUNCTI.ONS/RS 
FLX -- DEVICE HANDLER MISSING 
>FLX MM: /LI 

FLX -- DEVICE HANDLER MISSING 
>REM FLX 

>TIM 


13:13:07 O6-FEB-79 
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>; * FLX VERIFICATION COMPLETE * 
>; 

>3 

>; * DMP VERIFICATION * 

>; 

>TIME 


13:13:12 O06-FEB-79 
>INS SY:[1,54] DMP/TASK=...DMP 
>DMP TI:=ASRC.XXX/AS/RC 


DUMP OF DB3:[2,300]ASRC.XXX;1 - FILE ID 2171,1,0 
RECORD NUMBER 00. - SIZE 16. BYTES 


000000 DM P WORKS $ 


kk EOP **% 


>REMOVE ...DMP 


>TIME 
13:13:24 O06—-FEB-79 
>; 

; * DMP VERIFICATION COMPLETE * 

7 

; * CREF, PMD, AND PRT VERIFICATION * 

m7 

3 THIS ROUTINE OPERATES THE FOLLOWING UTILITIES: 

: MAC ,TKB,CREF,PMD,PRT 

7 

: IF ALL ARE FUNCTIONAL, AN EXAMPLE OF A MACRO LISTING WITH SYMBOL 
; AND MACRO CROSS-REFERENCE LISTINGS ATTACHED ARE SPOOLED TO 
: THE LINE PRINTER, A TASK ARE RUN AND IT CRASHES AND A 

: POST=MORTEM DUMP LISTING OF THE CRASHED TASK IS SPOOLED. 
>; 
>TIM 


13:13:44 06-FEB-79 

>INS [1,54] CRF/TASK=...CRF 

>i 

>MAC CRTEST,CRTEST/CR/-SP=CRTEST 
>TKB CRTEST/PM=CRTEST 

>; 

>PIP CRTEST.LST/SP 

PIP -- FAILED TO SPOOL FILE FOR PRINTING 
DB3:[2,300] CRTEST.LST; 4 

>; 

RUN CRTEST 

7 

>REM CRF 

TASK "TTO " TERMINATED 

ODD ADDRESS OR OTHER TRAP FOUR 
PC=001236 

PS=170001 

RO=000000 

Rl=111111 

R2=022222 

R3=033333 
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R4=044444 
R5=055555 
SP=001172 
POST MORTEM DUMP WILL BE GENERATED 


>TIM 
13:14:10 06-FEB-79 


; * CREF, PMD AND PRT VERIFICATION COMPLETE * 


; * DSC VERIFICATION * 


13:14:38 06-FEB-79 

>SET /UIC=[{2,300] 
f 
; -BECAUSE YOU DO NOT HAVE A FLOPPY DRIVE OR DEC TAPE, 
; AN AUTOMATIC VERIFICATION OF DSC OPERATION IS DEEMED 
; IMPRACTICAL. 
; THE DSC TEST IS BEING SKIPPED. 


v 
>PIP *.TMP;*/DE 
PIP -- NO SUCH FILE(S) 
SY0:([2,300]*.TMP;* 


¢ 


; * LBR VERIFICATION * 


13:14:52 06-FEB-79 

>INSTALL SY:[1,54] LBR/TASK=...LBR 

>; Create an object module library. 

>LBR OBJLIB/CR::: :OBJ 

>! Insert three object modules into the library. 
>LBR OBJ LIB/IN=OBJCT1 ,OBJCT2 ,OBJCT3 


>! Insert an existing module into the library (error expected). 


>LBR OBJ LIB/IN=OBJCT2 


LBR -- *FATAL*-DUPLICATE MODULE NAME "OBJ2 " IN OBJCT2.0BJ;1 


>! Replace two existing modules. 
>LBR OBJ LIB/RP=OBJCT1 ,OBJCT2 
MODULE "OBJ1 " REPLACED 


MODULE "OBJ2 " REPLACED 


>! Display. the contents of the object module library. 
>LBR OBJ LIB/LE/FU 

DIRECTORY OF FILE OBJLIB.OLB;1 

OBJECT MODULE LIBRARY CREATED BY: LBR V06.00 

LAST INSERT OCCURRED 6-FEB-79 AT 13:15:27 

MNT ENTRIES ALLOCATED: 256; AVAILABLE: 253 

EPT ENTRIES ALLOCATED: 512; AVAILABLE: 506 

FILE SPACE AVAILABLE: 21897 WORDS 

RECOVERABLE DELETED SPACE: 00150 WORDS 


** MODULE:OBJ1 SIZE:00075 INSERTED:6-FEB-79 IDENT:ID 1 


ENTSA1L ENTSB1 
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** MODULE: OBJ 2 SIZE:00075 INSERTED:6-FEB-79 IDENT:ID 2 


ENTSA2 ENTSB2 
** MODULE: 0OBJ3 SIZE:00075 INSERTED:6-FEB-79 IDENT:ID 3 


ENTSA3 ENTSB3 


>PIP OBJLIB.*;*/DE 

>REMOVE ...LBR 

>TIME 

13:15:59 06-FEB-79 

>} * LBR VERIFICATION COMPLETE * 


>} * PAT VERIFICATION * 
>; -_, 
>TIME 
13:16:04 06-FEB-79 
>INSTALL [1,54] PAT/TASK=...PAT 
>! Create an updated object file. 
>PATCH PATCHD.PAT=OBJCT1 ,PATCH1 
>! Compare the updated object file with one of known quality. 
>CMP TI:=PATCHD.PAT,PATCHD.XXX 
1) PATCHD.PAT;1 
2) PATCHD.XXX;1 


NO DIFFERENCES FOUND a, 
TI:s:=PATCHD.PAT,PATCHD.XXX 
>PIP *,PAT;*/DE 
>REMOVE ...PAT 


>TIME 

13:16:22 06-FEB-79 

>; * PAT VERIFICATION. COMPLETE * 

>; 

>; * SLP VERIFICATION * 

Pi. 

>TIME 

13:16:27 06-FEB-79 ae, 


>INSTALL [1,54] SLP/TASK=...SLP 
>! Invoke the SLP Editor to edit a data file. 
>SLP @SLPCMD ! "SLP OUTPUT.SLP,LIST.SLP/-SP=SLPDAT.XXX" 
>! Verify that the editing was properly performed. 
>CMP TI:=OUTPUT.SLP,SLPOUT.XXX 
1) OUTPUT.SLP;1 
2) SLPOUT.XXX;1 


NO DIFFERENCES FOUND 5 
TI:=OUTPUT.SLP,SLPOUT.XXX 
>PIP *.SLP;*/DE 
>REMOVE ..-SLP 


>TIME 

13:16:46 06-FEB-79 7 
>; * SLP VERIFICATION COMPLETE * 

>; 

>; * INTERACTIVE UTILITIES VERIFICATION * 

>; 

>; ENTER A CHARACTER TO CONTINUE FROM EACH 

>; EDITOR SUCCESSFULLY INVOKED AND CTRL Z TO EXIT FROM ACNT. 
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>TIM 

13:16:57 06-FEB-79 
>EDI QQQQ.XXX 
[CREATING NEW FILE] 
INPUT 


2ABO EDI 


TASK "...EDI" TERMINATED 
ABORTED VIA DIRECTIVE OR MCR 


>PIP QQQQ.XXX;*/DE 


; 
>INS [1,54] EDT 


2ABO EDT 


TASK "...EDT" TERMINATED 

ABORTED VIA DIRECTIVE OR MCR 

>} 

>REM EDT 

>ZAP 

ZAP > 

>ABO ZAP 

TASK "...ZAP" TERMINATED 

ABORTED VIA DIRECTIVE OR MCR 

>INS [1,54] ACNT/TASK=ACNT 

>RUN ACNT 

‘* ACCOUNT FILE MAINTENANCE PROCEDURE * 
OPTIONS ARE: A - ADD, C —- CREATE, D - DELETE, E - EXAMINE, 
L - LIST, M — MODIFY, S - SORT, CTRL/Z - EXIT 
ENTER OPTION: “Z 

OPERATION COMPLETE 


> 
>REM ACNT 
>TIM 
13:17:22 O06-FEB-79 
>; 
; * INTERACTIVE UTILITIES VERIFICATION COMPLETE * 
>; 
>UNL MM: 
UNL -- DRIVER NOT LOADED 


>PIP *.DAT;*/DE 

>; 

>; IF ANY ERRORS HAVE BEEN LOGGED BY ERROR LOGGER, WHEN THE COMMAND FILE EXITS 
>; YOU SHOULD PRINT SY:[{2,300]ERRLOG.LST AND INVESTIGATE THE ERRORS. 


>; 

>ERF 

ERF -- REQUESTED "ERRLOG" TO STOP LOGGING 
ERL -- LOGGING ENDED AFTER 9 ERRORS 


>INS LB:$PSE 

>INS LB:SSYE 

INS -- PARTITION PAR14K NOT IN SYSTEM, DEFAULTING TO GEN 
> 

2PSE SY:=SY: 

>SYE SY:=SY:/-SP 


3 

>RUN ERRLOG 

ERL -- ERROR LOG INITIALIZED 
> 

>; 

>REM PSE 
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>REM SYE 


>; IF YOU WANT TO REMOVE FROM THE SYSTEM ALL FILES ASSOCIATED 
+ WITH THIS PROCEDURE, ANSWER THE FOLLOWING QUESTION WITH N. 
; THE ANSWER Y (FOR "YES, SAVE") LEAVES THE TASK, DEFINE, 
7 INSTALLED. ALL NECESSARY FILES REMAIN ON THE SYSTEM DISK TO 
; ENABLE A REPEAT RUN. 
>* DO YOU WISH TO SAVE THE PROCEDURE TO RUN AGAIN? [Y/N] :Y 


© RA KKKEKKKEKEEKEEKEEKKEEEKREKKREKEKEKEERKRERKREKRKEKEEKKKEEKREEEKRKEEKKKKKKKKKE 


13:18:07 06-FEB-79 


; *** END OF RSX-11M V3.2 INSTALLATION VERIFICATION *** 


’ 
>: REKKKEKKEKKEEEKREKREKKEKEKEREREKEREEKEREKREKERKKKEKKKKKEEKEKKKKRKKKKKKKKRKK 


>@ <EOF> 


10.5 ERROR CODES 


The following text is a compilation of the error codes produced by the 
various modules in the RSX-11M Installation Verification Procedure. 
All the modules print an error number that is either the contents of 
F.ERR(RO) for I/O errors or S$DSW for Executive directive status codes. 


DEFINE.TSK - System Configuration Module 


When an error occurs, DEFINE.TSK prints "DEFINE ERROR # nn ccc", where 
nn is the number of the error and ccc is the contents of F.ERR(RO) for 
I/O errors or SDSW for Executive directive status. Both F.ERR- and 
SDSW appear in octal word format. Therefore, when the high-order byte 
shows as a minus one, it indicates that the error is from an Executive 
directive. The number of the error refers to the instruction that 


caused it. Below is a list of possible error numbers’ and their 
meanings. 


ERROR # DEFINITION 

l OPENSW - OPEN TO CREATE CONFIG.CMD FILE FAILED 

2 OPENSR - OPEN FILE TAILOR.DAT FOR READ (FDB=FDTAIL) 
FAILED 

3 READS - READ OF FILE TAILOR.DAT FAILED (FDB=FDTAIL) 

4 WAITS - WAIT FOR FILE TAILOR.DAT (FDB=FDTAIL) 
FAILED 

5 CLOSES - CLOSE OF FILE TAILOR.DAT (FDB=FDTAIL) 
FAILED 

6 CLOSES ~ CLOSE FAILED FOR CONFIG.CMD FILE 

8 PUTS - OUTPUT TO CONFIG.CMD FILE FAILED 


19 EXITSS 


EXIT FAILED 


LOGGER.TSK - Monitoring Task for QT Load Tasks 


When an error occurs, LOGGER.TSK prints "LOGGER ERROR # nn ccc", where 
nn is the number of the error and ccc is the contents of F.ERR(RO) for 
I/O errors or of $DSW for Executive directive status. Both F.ERR- and 
SDSW appear in octal word format. Therefore, when the high-order byte 
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Shows as a minus one, 


directive. 
caused it. 
meanings. 


The 


it indicates that the error is from an Executive 
number 
Below is a 


of the error refers to the instruction that 


list of possible error numbers and their 


ERROR # DEFINITION 
1 OPENSW Failure of open for write to RUNLOG.DAT 
file. 
2 OPENSW Failure of open for write to ERRLOG.DAT 
file. 
3 PUTS Failure of write to ERRLOG.DAT or RUNLOG.DAT 
file. 
4 PUTS Failure of write to ERRLOG.DAT file. 
5 PUTS Failure of write to ERRLOG.DAT or RUNLOG.DAT 
file. 
6 PUTSR Failure of write to RUNLOG.DAT or ERRLOG.DAT 
file. 
7 WSIGSS Wait for significant event directive failure. 
10 RCVDSC Receive data directive failure. 
11 ALUNSS Assign LUN directive failure. 
12 WTSESC Wait for significant event directive failure. 
13 SETFSS Set event flag directive error. 
14 SDATSS Send data directive failure. 
15 CLOSES Close failure of RUNLOG.DAT or ERRLOG.DAT 
file. 
16 GTIMSC Get time directive failure. 
17 CLEFSS Clear event flag directive failure. 


NUL1.TSK ~- One Form of the QT Load Tasks 


When a directive error occurs, the QT load task prints "TASK QTnn 
ABORTING", where nn is the task number that identifies the specific 
task. The module then displays an error identifying number as "ERROR 


# nn". It then displays the octal error code found in $DSW. The error 
codes in S$DSW are defined in the RSX-11M/M-PLUS Executive Reference 
Mani RSX-11M_ Mini-Reference. Below is a list of possible 
error numbers and their meanings. 


Manual or 


ERROR # DEFINITION 

0 SPNDSS Suspend directive issued by QT task failed. 

l RCVDSC Receive Data directive failed (receive from 
CONFIG). 

3 ALUNSS Assign Logical Unit Number directive failure 
to use TT# received from CONFIG.TSK 

4 MRKTSC Mark Time directive failure. 

5 EXIFSS Exit directive failure. 

6 DSCPS$S Disable Checkpointing directive failure. 

7 SDATSS Send Data directive failure (send to LOGGER 
before exiting). Insufficient dynamic 
memory can cause this error. 

8 ASTXSS AST Service Exit directive failure. 

12 CLEFSC . Clear Event Flag directive failure. 


QTRUN.TSK - Start Up the QT Load Tasks 


When an error occurs, 
nn is the number of the error and ccc is the contents of F.ERR(RO) for 
I/O errors or of SDSW for Executive directive status. Both F.ERR_= and 


QTRUN.TSK prints "“QTRUN ERROR # nn ccc", where 
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SDSW appear in octal word format. Therefore, when the high-order byte 
Shows as a minus one, 


directive. 
caused it. 
meanings. 


ERROR _# 


1 


[ee] ~] HO Ul & W Pd 


The 


OPENSW 
OPENSR 
READS 
WALTS 
CLOSES 
CLOSES 
GPRTSC 
PUTS 
RSUMSS 
ROSTSS 
WSIGSS 
RSUMSS 
ROSTSS 
SDATSS 
SDATSS 
RSUMSS 
EXITSS 


GTIMSC 
ALTPSC 


MRKTSC 


it indicates that the error is from an Executive 
number 
Below is a 


of the error refers to the instruction that 


list of possible error numbers and their 


DEFINITION 


Open failure on DVLREM.CMD or DVLSET.CMD 
file. 

Open failure on TAILOR.DAT file. 

Read failure on TAILOR.DAT file. 

Wait failure on TAILOR.DAT file. 

Close failure on TAILOR.DAT file. 

Close failure on DVLSET.CMD file or 
DVLREM.CMD file. 

Get Partition Parameters Executive directive 
failure. 

Write failure for .CMD files created by 
QTRUN. 

Resume Executive directive failure for DUMMY 
task. 

Request Executive directive failure for 
LOGGER task. 

Wait for Significant Event Executive 
directive failure. 

Resume Executive directive failure. 
Request Executive directive failure. 
Send Data Executive directive failure 
(failure of Send Data to QT task). 

Send Data Executive directive failure 
(failure of Send Data to Logger task). 
Resume Executive directive failure. 

Exit Executive directive failure. 

Get Time Executive directive failure. 
Alter Priority Executive directive failure 
(alteration of indirect command file 
processor failed). 

Mark Time Executive directive failure. 
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All 
The 


CHAPTER 11 


SYSGEN ERROR MESSAGES 


messages from SYSGEN appear in this chapter in alphabetical order. 
descriptions that follow each message explain the possible cause 


and, aS necessary, suggest remedial action. 


SGN 


SGN 


SGN 


SGN 


SGN 


SGN 


-- Attempt to use non-existent default for parameter parm -- RETRY 


Explanation: A required parameter (number "parm") was missing 
from the response to the current peripheral question. Reenter 
the entire response. Note that the [L/R] parameter does not 
count. 


-- Baseline terminal driver not valid option with multiuser 
protection selected. 


Explanation: The half duplex baseline terminal driver includes 
no SYSGEN options and cannot execute in a multiuser protection 
system (for example, breakthrough write is required but not 
included). Choose a different terminal driver. 


-- CO driver not valid on RSX-11S systems -- SUPPRESSED 


Explanation: RSX-11S systems cannot include the console driver 
(CO). SYSGEN ignores this entry. 


= cb driver not valid on unmapped system -- SUPPRESSED 


Explanation: Unmapped systems cannot include the console driver 
(CO). SYSGEN ignores this entry. 


-- Correct problems and reassemble the bad modules SYSGEN will 
continue when done. 


Explanations This message indicates that you detected an error 
in assembling the Executive or the device drivers (you responded 
No at either the Executive or driver EOX breakpoint). After you 
correct the error, reassemble the bad modules and SYSGEN will 
continue. 


-- Correct problems -~- SYSGEN will restart assemblies when done 
Explanation: This message indicates that you detected an error 
in assembling the laboratory peripheral devices. After you 


correct the error, SYSGEN will attempt to re-assemble_ the 
laboratory peripherals common area(s). 
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-- DM11-BB CSR address must be greater than 157777 if 
specified -- RETRY 


Explanation: If the system includes a DM11-BB, the CSR address 


must be greater than or equal to 160000. If not included, the 
CSR address must be zero. 


-- DM11-BB vector address must be greater than 277 if 
specified -- RETRY 


Explanation: If the system includes a DM11-BB, the interrupt 
vector address must be greater than or equal to 300. If not 
included, the vector address must be zero. 


~~ Dynamic storage space must be in multiples of two 
words -- RETRY 


Explanation: The system allocates pool in 4-byte sections. 
Thus, the amount of pool must be a multiple of 4 bytes. 


-- GR not valid on system with more than 124K -- SUPPRESSED 


Explanation: The graphics display driver (GR) does not execute 
on 22-bit processors. If your system includes a GR, the maximum 
amount of memory is 124K. If you have a GR and wish to use it, 
type CTRL/Z and restart specifying 124K or less for memory size. 


-- Illegal character in numeric response -- RETRY 


Explanation: A character other than 0-7 for an octal response or 
0-9 for a decimal response was entered. Note that the use of 
special characters (# or .) to indicate an explicit octal or 
decimal response is forbidden. 


-- Illegal device mnemonic 
Explanation: This message applies only to dual RKOS kit users 
that answered Y to question 9 (skip end of disk (EOD) 
breakpoints). If you wish to ignore EOD breakpoints, you must 
enter the device that contains the driver source files. The 
message indicates that you incorrectly specified the driver 
source device; enter a minimum of two characters. 
-- Illegal device mnemonic -- RETRY 
Explanation: You specified a drive type that the device does not 
support (such as RPO6 for a DL device). 


-- Illegal numeric answer -- RETRY 


Explanation: See the description of Illegal character in numeric 
response. 
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-- Illegal printer specification -- Valid types are LP1l1-C, D, F, 
H, J, K, R, S, V, W, Y, Z, LS1l1, LA180, and LV1l -- RETRY 


Explanation: SYSGEN only Supports the above named line printer 
controllers. If you have a different controller, refer to the 
peripheral question concerning LP: to match your printer 
characteristics with a DEC standard printer. 


-- Illegal trailing characters or extra parameters “parm" -- RETRY 
Explanation: You have specified more parameters than allowed for 
this response. Remember that parameters in brackets can only be 
specified for the first controller of this type. 

-- Invalid directive code "direc-code" 

Explanation: You have entered other than A, B, C, D, E, F, G, H, 
I, or %. The line is discarded. 
-- Invalid system device -- RETRY 


Explanation: The device specification for the Executive source 
disk was improperly or incorrectly entered. 


Big disk kits: The default response is SY:; enter either Y or 
carriage return. Otherwise, you must enter at least’ two 
characters to identify the device that contains the Executive 
sources. 


Dual RK or RLO1 kits: There is no default response to this 
question. Enter the device (minimum two characters) that 
contains the Executive sources. 
-- Listing files cannot be sent directly to LP: -- RETRY 
Explanation: Spooled listings must go to a real device. Also, 


for online SYSGENS, maps cannot go directly to the line printer. 
If you want to print at LP:, specify LPO:. 


-- Loadable driver support waS not selected in the Executive 
section of SYSGEN. Device cannot be made loadable -- RETRY 
Explanation: You did not include loadable driver support in the 
system. All device drivers must be resident. 

-- Loadable/Resident indication not valid for this device -- RETRY 
Explanation: Loadable or resident is not an option for this 
device. 

-- Maps cannot be sent directly to line printer -- RETRY 
Explanation: Spooled maps must first go to a spool device. 


Also, for online SYSGENS, the maps cannot go directly to the line 
printer (specify LPO:). 
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-- Maximum of 1 CRT monitor possible with VT1l1 -- RETRY 
Explanations A VS60 can support two CRT monitors, but a VT1l 
supports only one. 

-- Maximum of 8 printers allowed on a system with a KMC -- RETRY 


Explanation: The KMC-11 supports up to eight line printers. 


-- Maximum of nn. controllers allowed for device dd -- RETRY 
Explanation: The specified device supports nn controllers. Note 
that pseudo devices can only indicate one controller. Terminal 
driver hardware controllers are specified later. 

-- Memory size inconsistent with mapping option 
Explanation: The maximum memory size for an unmapped system is 
28K-words. The minimum memory size for a mapped system is 
24K-words. You have either specified (in question 4, Memory 
size) more than 28K-words of memory for an unmapped system 
(question 5) or less than 24K-words of memory for a _ mapped 
system. 

-- Memory not multiple of 4K 
Explanations: When you specify memory size, it must be an even 
multiple of 4. 

~- More than 252. modules specified -- RETRY 
Explanation: The UDC-11 supports a maximum of 252 modules. You 
have specified more than the maximum. 

-- Number of interrupts must be divisible into 10,000. 
Explanation: The number of interrupts per second for the KW11-P 
clock was not 1, 2, 4, 5, 8, 10, 16, 20, 25, 40, 50, 80, 100, 
125, 200, 250, 400, 500, 625, 1000, 1250, 2000, 2500, or 5000. 
Note that more than 100(10) clock interrupts per second 
Significantly increases system overhead. 


-- Number of samples must be evenly divisible into 10000. -- RETRY 


Explanation: Sampling rate must be evenly divisible into 10000. 


-- Overlapping modules -- RETRY 
Explanation: The last module specified attempts to use _ slots 


that you have indicated occupied by other modules. Review your 
configuration and try again. 
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-- Parameter (#N) "parm" out of range n to n -- RETRY 

Explanation: The indicated parameter (excluding 
Loadable/Resident) is not within the acceptable range. 
-- Pausing to allow copying of [ggg,10] files to baseline disk 


Explanation: This message applies to RLO1 kit users only. 


-- Pausing to allow editing of Executive source 


Explanation: This is not an error message; the message is 
informative. It indicates that you wish to edit Executive files. 


-- Pausing to allow loading of EXCSRC disk 


Explanation: This message applies to dual RKO5 kit users’ only. 
The message indicates that SYSGEN will pause while you load the 
EXCSRC disk into the proper drive. 


-~- The full duplex terminal driver requires memory management = and 
loadable driver support. If you desire the full duplex driver, 
you must repeat the Executive questions and select these options. 


Explanation: As the message states, you must include memory 
management directives (PLAS) and loadable driver support to 
select the full duplex terminal driver. 

-- Unable to determine system type -- assuming unmapped 
Explanation: This message applies to RLO1 kit users only. When 
you generate a mapped system, you must use a mapped system. 
Likewise, when generating an unmapped system, use an unmapped 
system. This message indicates that the system UIC has been 
changed and does not end in 0 or 4; SYSGEN must choose. 


-- Unit number must be an integer in the range 0 to 7 


Explanation: The crash device must be unit number 0-7 inclusive. 


-~- Unrecognizable string "ddn" -- Ignored 


Explanation: SYSGEN could not parse the indicated String. 
Perhaps you omitted a comma. 


-- Valid char detec expan unit indics. are "C" (yes) and "NO" 
(no) -- RETRY 
Explanation: Valid responses for this paramter are C, to 


indicate that controller includes character unit, and NO, to 
indicate it does not. 
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-~ Valid D/A present indicators or “p" (yes) and "No" 
(no) -- RETRY 


Explanation: Valid responses for this parameter are D, to 
indicate that controller includes D/A converter, and NO, to 
indicate that it does not. 


-- Valid devices: DT, DK, MT, MS, MM, DB, ODM, DL, ODD, & 
DR -- RETRY 


Explanation: The CDA routine does not support the device you 
entered as a dump device. 


-- Valid DR11-K present indicators are "DRK" (yes) and "NO" 
(no) -~- RETRY 


Explanation: Valid responses for this parameter are DRK, to 
indicate that DR11-K is present, and NO, to indicate that it is 
not. 


-- Valid duplex indicators are "H" and "F" -- RETRY 
Explanation: Valid responses for this parameter are H, to 


indicate a half duplex line, and F, to indicate a full duplex 
line. 


-- Valid err detec expand unit indics. are "E" (yes) and NO 
(no) --~- RETRY. 

Explanation: Valid responses for this parameter are E, to 
indicate that error detection expander unit is present, and NO, 
to indicate that it is not present. 

-- Valid indicators are "H", "F", and "P" -- RETRY 

Explanation: Valid responses for this parameter are H, to 
indicate half duplex line, P, to indicate primary station of 
line, and F, to indicate full duplex line. 

~- Valid graphic device indicators are "VT11" and "VS60" -- RETRY 
Explanation: Valid responses for this parameter are VT1ll, to 


indicate a VTll graphics display device, and VS60, to indicate 
VS60 graphics display device. 


-- Valid line speeds are 50, 75, 110, 134.5, 150, 200, 300, 600, 
1200, 2400, 4800, and 9600 -- RETRY 


Explanation: The controller does not support the specified line 
speed. 
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-- Valid listing devices are: SY:, Ths, and "None" 
(default) -- RETRY 


Explanation: When performing an RSX-11S system generation using 
an IAS host system, the listing device must be SY: or TI:. 


-- Valid map devices are: SY:, TI:, and "None" (default 
SY:) -- RETRY 


Explanation: When performing an RSX-11S system generation using 
an IAS host system, the map device must be SY: or TI:. 


-- Valid offset recovery indicators are "O" (yes) and "NO" 
(no) -- RETRY 


Explanation: Valid responses for this parameter are 0, to 
indicate that all of this controller type support offset 
recovery, and No, to indicate that none of the controllers of 
this type support it. 


-- WARNING -- CPU does not have switch register -- Get sense 
switch directive not included 


Explanation: The processor you specified does not have a_ switch 
register. Thus, you cannot use the get sense switch directive. 
If you wish to include the directive, edit RSXMC.MAC and add_ the 
line GSS$TSS=0. 


-- WARNING -~ Null device forced into system 


Explanation: This message indicates that SYSGEN has’ forced the 
null device into your configuration. The null device is required 
to redirect data normally sent to either the system disk or _ the 
terminal driver (both of which your system does not include). 


-~- WARNING -- Terminal driver forced into configuration 
Explanation: RSX-11M requires a terminal driver for operation. 
You forgot to specify a terminal driver so SYSGEN put one in for 


you. Later, SYSGEN will ask which terminal driver you want’ to 
use, 
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STPR 


SSWR 


$11s 


STME 


SMAP 


SKSR 


SEAE 


SFPP 


SFIS 


SPRO 


SLIN 


SWAT 


SMPR 


$SCAH 


SHIV 


SDEV 


SETS 


~SETT 
~SETF 


-SETT 
-SETF 


~SETN 


»SETT 
» SETF 


»SETT 
» SETF 


oSETT 
oSETF 


oSETT 
~SETF 


eSETT 
-SETF 


~SETN 


eSETS 


eSETT 
-SETF 


oSETT 
-SETF 


~SETT 
-SETF 


~SETN 


eSETS 


APPENDIX A 


SYMBOLS FOR SAVED ANSWER FILES 


Definition 
Processor type (for example "11/60") 


Processor has a switch register 
Processor does not have a switch register 


Generating RSX-11S 
Generating RSX-11M 


Memory size in K-word blocks 


Generating mapped system 
Generating unmapped system 


System includes K-series laboratory peripherals 
System does not include K-series laboratory 
peripherals 


System includes extended arithmetic element 
System does not’ include extended arithmetic 
element 


System includes floating point processor 
System does not include floating point processor 


System includes floating instruction set 
System does not include floating instruction set 


Number of KW11-P clock 
excludes KW11-P) 


interrupts/second (0 


Line frequency (A=60Hz, B=50H2) 


System includes KW11-Y watchdog timer 
System excludes KW11-Y watchdog timer 


System includes memory parity support 
System excludes memory parity support 


System contains cache memory 
System does not contain. cache memory 


Highest interrupt vector address (if highest 
vector specified or less than 400, SYSGEN 
recalculates; S$HIV not saved until peripheral 
section is complete) 


Peripheral devices and number of controllers 


SYMBOLS FOR SAVED ANSWER FILES 


Symbol Definition 
$DV2 eSETS Peripheral devices and number of controllers _ 
$DV3 -SETS Peripheral devices and number of controllers 
SONL -SETT Online SYSGEN 
.SETF Standalone SYSGEN 
SLPR ~SETT Host includes a line printer : 
~SETF Line printer not available on host 
SSPL »SETS "/SP" spool listings and maps, 
"/-SP" do not spool 2 
SPWI ~SETT Printer width at least 120 columns 
~SETF Printer width less than 120 columns 
SALD ~SETS Device mnemonic for assembly listing files no 
trailing ":", SY: is "" 
SMPD ~SETS Device mnemonic for Executive and device driver 
maps am 
SDBM ~SETT DBMS-11 support 
~SETF No DBMS-11 support 
$F1l ~SETT Files-11 ACP support 
~SETF No Files-11 ACP support 
SRMS eSETT Record Management System support 
-SETF No RMS support 
SNRT ~SETT Non-resident task support am, 
~SETF No task loader support 
SLLR «SETT Loadable task loader 
~SETF Resident task loader 
SMMD ~SETT Memory management directives support 
~SETF No PLAS support 
SSRR eSETT Send/receive by reference support 
~SETF No send/receive by reference directives 
SGMC ~SETT Get mapping context support 
~SETF No get mapping context directive 
SACK ~SETT Address checking support 
~SETF No support 
SIOR ~SETT I/O rundown support 
-SETF No support 
a 
SMUP ~SETT Multiuser protection support 
~SETF No support 
SANM ~SETT ANSI magtape support 
~SETF No support . 
$OUD ~SETT Online formatting and user-mode diagnostic support 
-SETF No support 
$LOD ~SETT Loadable driver support a, 
~SETF Resident drivers only 


Symbol 
SLLD 
SAST 
STKT 
SPRF 
SIRR 
$20K 
$LGD 
$DTO 
SUNI 
SPAR 
SUWD 
SGTW 
SPTW 
SWCH 
SXDT 
SROT 
SNET 
SPRN 


SGGE 


eSETT 
~SETF 


~SETT 
~SETF 


~SETT 
~-SETF 


~SETT 
»SETF 


~SETT 
-SETF 


~SETT 
~SETF 


~SETT 
~-SETF 


~SETT 
-SETF 


~SETT 
~-SETF 


~-SETT 
~SETF 


~SETT 
~SETF 


~SETT 
-SETF 


eSETT 
~SETF 


~SETT 
~SETF 


~SETT 
~SETF 


~SETT 
~SETF 


~SETT 
~SETF 


~SETT 
~SETF 


~SETT 
~SETF 


SYMBOLS FOR SAVED ANSWER FILES 


Definition 


All loadable drivers loadable 
All loadable drivers (except full duplex 
built as resident 


AST support 
No support 


TKTN support 
No support 


Power fail recovery support 
No support 


Install-run-remove on exit support 
No support 


20K Executive 
16K Executive 


Logical device assignment Support 
No support 


Log device errors and interrupt timeouts 
No logging 


Log undefined interrupts 
No logging 


Log memory parity errors 
No logging 


System to include user-written driver 
No user-written drivers 


System includes get word Executive routine 
System excludes get word Executive routine 


System includes put word Executive routine 
System excludes put word Executive routine 


System supports disk writecheck 
No support 


System supports Executive Debugging Tool 
No XDT 


Rotating data lights 
No rotating lights 


Industrial network and DECnet support 
No network support 


System supports queue manager 
No queue manager 


Group global event flag support 
No support 


TTDRV) 


Symbol 


SDRR 


SNPK 
SDTV 
SRRS 
SHIC 
SLOC 


SDKS 


SRSD 


SCKP 


SMEM 


SCRA 
SNOT 
SMDD 
SMDC 


SPDD 
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~SETN 


~SETN 


-SETN 


-oETN 


~SETN 


-SETN 


~SETN 


~SETN 


-SETN 


SETS 


SETS 


-SETS 


~SETN 


SETS 


~SETN 


-SETN 
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Definition 
Executive directives code: "ABCDEFGHI" 
(A= get partition parameters, B= get task 
parameters, C= send/receive, D= alter priority, E= 
extend task, F= connect to interrupt vector, G= 


get sense switch, H= parent/offspring tasking, I= 
stop bit) 


Number of pre-allocated QIO packets (0= no QIO 
speed optimizations) 


Size of data transfer vector in words (if S$NPK=0, 
SDTV=0) 


Round-robin scheduling interval (0 excludes 
round-robin scheduler) 


Highest priority class for round-robin scheduling 
(if S$RRS=0, SHIC=0) 


Lowest priority class for round-robin scheduling 
(if SRRS=0, $LOC=0) 


Swapping interval for Executive level disk 
swapping (0 excludes Executive level disk swapping 
support) 


Executive level disk swapping range (swapping 
priority) (if $DKS=0, SSWP=0) 


Size of dynamic storage region (pool space) 


Seconds between line printer not ready messages (0 
suppresses messages) 


Seconds between card reader not ready messages (0 
suppresses messages) 


CSR address for register and stack dump device (0 
excludes stack and register dump following crash) 


Checkpointing (A= checkpointing, B= checkpointing 
with system checkpoint file, empty string = no 
checkpointing support) 


System controlled partitions (A= system 
controlled, B= with the shuffler, empty string = 
no system controlled partitions) 


Dump routine (A= PANIC, B= CDA, empty string = no 
memory dump routine) 


CSR address for CDA crash notification device (if 
SCRA not equal B, $NOT not in file) 


Device mnemonic for CDA memory dump (if SCRA _ not 
equal B, SMDD not in file) 


CSR address of CDA dump device (if SCRA not equal 
B, SMDC not in file) 


CSR address of PANIC dump device (if SCRA _ not 
equal A, SPDD not in file) 


* 


Symbol 
STTY 


STMN 


SFRM 
SACR 
STCK 
SUSC 
SCNO 
SBWS 
SCNR 
SESC 
SMLC 
SSMC 
SGTD 
SHSM 
STRW 
$SCC 
SRAP 
SRNE 
SRST 
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Definition 


Terminal driver (A= tailorable half duplex, B= 
user oriented half duplex, C= full duplex, D= 
baseline half duplex) 


Timeout value (if STTY not equal C, S$TMN not in 
file) (0 excludes support for unsolicited input 
timeout feature) 


Pass form feeds directly to terminal 
Convert form feeds into 8 line feeds 


Support automatic carriage return/line feed 
No support 


Task checkpointable during terminal input support 
No support 


AST on unsolicited input character 
No support 


CTRL/O cancellation support 
No support 


Breakthrough write support 
No support 


CTRL/R support 
No support 


Process escape sequences 
No support 


Get multiple characteristics support 
No support 


Set multiple characteristics support 
No support 


Get terminal driver options support 
No support 


Hold screen mode support 
No support 


Transparent read write support 
No Support 


Settable case conversion support 
No lower to upper case conversion 


Read after prompt support 
No support 


Read with no echo support 
No support 


Read with special terminator support 
No support 


CRT rubout support 
No backspace deletion 


Symbol 
STHS 


STIB 
SVTB 
$L30 
SHRE 
$DIC 
$EDX 
SADR 
SINI 


SADL 


SMOU 
SUFD 
SIPE 
SCDB 
$DUC 


SEXT 
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eSETT 
~SETF 


~SETT 
-SETF 


~SETS 


~SETT 
-SETF 


~SETT 
~SETF 


-SETT 
-SETF 


~SETT 
~SETF 


~SETT 
-SETF 


-SETT 
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Definition 


CTRL/S and CTRL/Q support 
No support 


User terminal input buffer support 
No support 


Variable length terminal input buffer support 
No support 


System includes LA30P 
No LA30P 


Hardware unrecoverable input error support 
No support 


Device independent cursor positioning support 
No support 


Pause to allow editing Executive files 
Do not pause 


Assembly listing device ready 
Assembly listing device not ready 


Assembly listing device must be initialized 
Device is initialized 


Assembly listing device label 


Mount assembly listing device 
Need not mount device 


Create listing UFD 
Do not create listing UFD 


Allow direct access to IP11/IP300 device registers 


Do not allow direct access 


Allow direct access to ICS/ICR modules 
Do not allow direct access 


Allow direct access to UDC11 modules 
Do not allow direct access 


Edit RSXMC to allow FORTRAN access to laboratory 


device registers 
Do not edit 
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Format of Saved Answers for Devices 
Controller: 
$$ [device-mnemonic] [controller number] 
For example: 
SETS $$MMO wpe 
Unit modifiers: 
$({controller number] [device-mnemonic] [unit number] 
For example: 


~SETN $OMMO 0 
~SETS SODY1 "DOUBLE" 


APPENDIX B 


RMDEMO 


B.1 INTRODUCTION 


RMDEMO is a privileged task that displays information concerning task 
activity in an RSX-11M system. The display usually runs continuously 
on a video terminal, such as the VTO5B or the vVT52. A single 
"snapshot" display can be run on a hard-copy terminal, such as an 


LA36. The display format adapts automatically to the type of terminal 
on which it runs. 


Typically, RMDEMO is set running on a slaved terminal near’ the 
computer as part of the system boot procedure. Individual users can 
also display RMDEMO on their terminals using the MCR command >RMD. 


RMDEMO should be installed under the name ...RMD for these commands to 
work. 


The display features include: 

1. Current date and time; 

2. The currently active task; 

3. All tasks, loaded drivers, and common blocks currently in 
memory, displayed in a graphic fashion to show their 
individual memory requirements and locations’ relative to 
other tasks; 

4. The number of active tasks currently in memory, the number 
not currently resident, and the total amount of memory 
occupied by each group; 

5. The current amount of available system dynamic memory (pool 
space), including the largest available block and the number 
of fragments; and the worst case of pool space. since 
bringing up RMDEMO; 

6. A graphic display of partition information; 


7. The number of free blocks available on the system device and 
three or more additional mounted FILES-11 volumes; 


8. The system error count sequence. 


RMDEMO 


RMDEMO scales the display to the memory size of the computer on which 
it is executed. The amount of memory displayed on the screen will 
always be the next largest multiple of 32 words. (In certain 
instances, this may cause an inaccurate amount of total memory to 
appear. For example, a 28K system running RMDEMO on an LA36 will 
display somewhat over 29K of total memory. This anomaly in a rare 
case was considered preferable to the alternative, which was to reduce 
resolution in the display.) 


Task locations and sizes displayed by RMDEMO should be considered 
approximate. RMDEMO is primarily designed to provide a visual display 
and system debugging tool. It does not accurately measure task size 
and location. 


B.2 HARDWARE REQUIREMENTS 


RMDEMO runs on RSX-11M and RSX-11S. It is non-overlaid and _ requires 
approximately 5K. 


B.3 BENEFITS OF USING RMDEMO 


In general, RMDEMO is a useful task designed to allow either an 
operator or user to view the current state of the operating system. 
The information is presented in a graphic, easily comprehensible form. 


There are a number of specific instances in which RMDEMO can help to 
locate certain system lockout problems or bugs in application and/or 
system-level software. 


1. Bugs and other situations that cause exhaustion of system 
dynamic memory (resulting in unexplained system hangs) may be 
detected and more easily reproduced and diagnosed. 


2. Task checkpointing and swapping may be monitored -- and in 
systems with limited memory, deadlock conditions may often be 
more easily diagnosed. 


3. Free space on a number of FILES-11 devices may be monitored 
in real time, which may help in situations where online 
storage is at a premium or where some program is’ running 
wild. 
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B.4 RMDEMO DISPLAY FIELDS 
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Figure B-l1 Example of RMDEMO Display 
1. The version number of the current system, base level, and 
memory size. 
2. The current date and time. 


3. The currently executing task; *IDLE* indicates that no task 
is executing (the Executive is executing the idle loop). 


4. Pool information in the format POOL=X:Y:Z where the first 


line is: 
X = size in words of the largest free block in pool; 
Y = total number of free words in the pool; 
Z = number of fragments in the pool free list. 


and the second line records the worst case of pool since’ the 
current execution of RMDEMO began. (This second line will be 
most useful on a slaved terminal that is started displaying 
RMDEMO when the system is booted. Otherwise, this second 
line gives worst-case pool information from the time you 
initiate the RMDEMO display on a terminal.) 


5. The number of free blocks on SY0: and up to 3 more’ selected 
FILES-11 devices. 


6. Number of active tasks in memory and the amount of memory 
they occupy, plus the number of active tasks checkpointed out 
(not in memory) and the total memory they would require. 


7. The name of each task in memory and a representation of other 
information about the task, including size. 


< > active task 
[ ] task not active, yet occupies memory 
! ! named common 


10. 


ll. 


RMDEMO 


+ + unnamed common, name displayed is first 
attached task 

( ) loaded loadable driver, name displayed is 
device mnemonic (see next entry) 

----- task is not fixed in memory 

===== task is fixed in memory 


The hyphens ( -) or equals ( =) display (very roughly) the 
amount and area of memory occupied by each task or driver. 
Where the display shows only one delimiter ( <, !, +, Ty (, 
etc.), the opening delimiter should be considered to appear 
in the same position as the closing delimiter of the 
preceding task. 


Loadable drivers loaded in memory, identified by device 
mnemonic. Although drivers are not tasks, they require 
memory, and thus are displayed with tasks. 


Partitions in the system. Partition name comes’ first, 
followed by a letter identifying the partition type. 
(Partition size is indicated in next entry.) The letters are 
defined as follows: 


task partition 

subpartition 

system-controlled (dynamic) partition 
common partition 


aqunegd 


Partition size and location. The beginning of each partition 
is marked by a letter in the same code as above, with the 
following additions: 


E 
P 


Executive 
Pool (dynamic storage region) 


The lines of asterisks ( * ) represent (very roughly) the 
proportional amount and area of memory occupied by each 
partition. 


The system error count sequence as recorded by the error 
logger. If error logging is not included in the system, 
ERRSEQ will always equal zero. 


B.5 DISPLAY CONFIGURATION OPTIONS 


Certain parameters can be altered by the user who wants to develop 
special versions of RMDEMO. The source file, located in UFD[14,10] on 
your distribution kit, contains extensive comments that should enable 


you to 
display, 
that can 
- the 
- the 


Type ESC 


alter the code to move or delete fields in the existing 
or design additional display pages. These are two parameters 
be changed on-line, from a running RMDEMO display: 

display rate (interval at which information is updated) 

names of the FILES-11 devices in the free-space display area. 


(ALT MODE or SEL) to display the command formats for changing 


these parameters. 


APPENDIX C 


CONSOLE DRIVER AND CONSOLE OUTPUT TASK 


Two facilities in RSX-11M -- the Console Driver and the Console Output 
Task (COT) -- handle messages sent to the console device (CO:). COT 
is a privileged task usually installed and maintained by the System 
Manager. You can use COT to direct messages to: 


e The default console output device (usually TTO:) 


e Any other terminal that you assign as the console device with 
the COT SET commands 


e A console message logging file 


COT SET commands allow you to assign the destination of the messages 
to alternate devices or to terminate messages to the console device or 
logging device. The Console Driver sends all messages to COT, which 
forwards them to the terminal or logging device that you have 
selected. 


COT permits you to specify any terminal as a console terminal and_ to 
change that specification, using privileged MCR SET commands. You are 
not restricted to using TTO0: as the console terminal. You can also 
change the name of the file to which COT writes. (Any part of the 
command file specification can be changed independently.) If COT is 
aborted or the system crashes, you can recover the information in the 
log file by using the Peripheral Interchange Program (PIP) to unlock 
the file. You can then print its contents. (PIP is described in the 
RSX-11 Utilities Manual.) 


The Console Driver and COT are supported on mapped RSX-11M_ systems. 
They are not supported on RSX-11S systems, because RSX-11S does not 
Support the disk volumes you need to use the Console Driver's 
write-to-a-file feature. 


C.1 OPERATING COT 


The COT commands control the selection and operation of the console 
terminal or the log file either separately or together. You can 
Start, control, and terminate console, log file, or COT operation by 
using one of the following privileged MCR SET commands: 


>SET /COTERM[=ttns: ] 

>SET /NOCOTERM 

>SET /LOGFILE[=ddnn:] [uic] [filename. filetype] 
>SET /NOLOGFILE 

>SET /COLOG [=TTn:] [ddnn:] [uic} [filename. filetype] 
>SET /NOCOLOG 
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NOTE 


The brackets indicate optional entries. 
However, brackets must be entered when 
specifying the UIC, as [UIC] 


Once COT is running, COT processes all messages directed to CO: (ina 
QIO operation, for example). COT gets the time, prints the message 
and time on the console terminal, and writes the information in a 
file. The default terminal is TT0O: and the default file is 
SY0:[1,4]CONSOLE.LOG, unless you specify another terminal or file. 


COT also uses the MCR SET commands to change or stop output to a 
terminal or file. You can change any COT option without stopping and 
restarting the entire task. 


C.1.1 Task Interfacing with COT 


Task interfacing with COT deals with the task's attempts to_- send 
messages, attach to, or read from the console terminal. 


Tasks can write messages to CO:. The buffer in COT accepts messages 
up to 256(10) bytes long. Therefore, any task sending longer messages 
must include carriage-returns/line-feeds in the text. Setting the 
buffer size to something other than 256(10) bytes can cause 
unpredictable results. 


When you have a task that must send a message to the console terminal, 
start the message with a CTRL/G. This message prints on the terminal 
regardless of the effect of a previously entered SET /NOCOTERM 
command. The CTRL/G causes COT to send the message to TTO: if no 
terminal is currently designated as the console terminal. The message 
goes to the current console terminal if one is designated. 


A task may not attach to CO:. If a task attempts to attach to CO:, an 
invalid function code error occurs. 


Only a task with the name COT... may read from CO:. If another’ task 
attempts to read from CO:, an invalid function code error occurs. 


C.1.2 Using the REDIRECT Command with COT 


When COT is not running, the system data structure (UCB) for CO: is 
directed to MTTO:. Messages directed to CO: therefore go to the 
terminal driver (TTDRV) and then to TTO0:. When COT starts, however, 
it directs CO: to CO: by adjusting the redirect pointer in the data 
structure. COT then receives messages directed to CO: and sends them 
to CODRV, which is the driver for console output. Therefore, to 
change the console terminal while COT is running, use the SET /COTERM 
command. When you use this command, COT changes the console terminal 
by issuing an Assign LUN Executive directive. If you use the REDIRECT 
command to affect the console terminal assignment while COT is 
running, device assignment problems or a system loop may occur as a 
result. 
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You may encounter two conditions when using the REDIRECT command to 
affect the console terminal assignment while COT is running. 


1. I£ you redirect CO: to another device, the device handler 
for the device at the end of the redirect chain receives the 
message meant for CO:. This means that you bypassed COT 
entirely. Therefore, messages do not go to CO: and they are 
not written on the logging device. 


The console driver (CODRV) must receive messages sent to CO: 
for COT to work properly. CODRV receives the messages only 
if cO: is directed to CO:. 

2. You can use SET /COTERM to specify a different terminal for 
output. If you do this, do not use REDIRECT to redirect that 


terminal back to CO:. Using REDIRECT in this way causes a 
system loop that prevents any other processing on the system. 


C.2 COMMAND DESCRIPTIONS 
COT commands fall into three categories: 

1. Commands that control the console 

2. Commands that control the log file 

3. Commands that control both the console and the log file 
In the commands in which you specify all the options, the options must 
be specified in the order shown. Left and right brackets indicate 
that the enclosed specification is optional. However, brackets must 
be entered when specifying the UIC as [UIC]. 
In the commands that have optional file specifications 
(ddnn: [UIC] filename.filetype), the default file specification is 


SY0:(1,4]CONSOLE.LOG. Leaving out the device causes SY0: to be used 
and leaving out the filename.filetype causes CONSOLE.LOG to be used. 


C.2.1 Commands that Control the Console 


The following commands either start (or stop) COT or assign the 
console terminal. 


>SET /COTERM[=TTn:] 
>SET /NOCOTERM 
Description 
>SET /COTERM 


If COT is running, this command (without the MTTn: option) 
assigns the default (TTO:) as the console terminal. 


If COT is not running, this command starts COT and assigns’ the 
default (TTO:) as the console terminal without a log file. 
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Option 
TTns 
Specifies the terminal to be assigned as the console terminal. 


If COT is running, using the command with this option reassigns 
the console terminal. 


If COT is not running, the command starts COT and assigns’ the 
specified TTn: as the console terminal without a log file. 


In either case, you cannot designate a log file with this 
command. 


Description 
>SET /NOCOTERM 
This command terminates the output of messages to the console 


terminal. You can restart the logging of messages on the console 
terminal by using the appropriate SET command. 


C.2.2 Commands that Control the Log File 


The following commands control both the log file and the device on 
which it is written. 


>SET /LOGFILE[(=ddnn:] [(UIC]] [filename. filetype] 


>SET /NOLOGFILE 


Description 

>SET /LOGFILE[=ddnn:] (The default is SY:) 
If COT is running, this command terminates output to the current 
log file and opens a new log file on the specified device. The 


new log file is one version higher than the version of . the 
current file. 


If COT is not running, this command starts COT with the default 
log file (if you do not use a file specification) on the 
specified device. This command does not assign a_e console 
terminal. 


The device-unit specification is ddnn:. 


Options 
[uic] 


Specifies the UIC to which the log file is written. The brackets 
must be used. 
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filename. filetype 
Specifies the file name and file type of the new log file. 
If COT is running, the command with this option specified 
terminates the current log file and opens a new log file with the 
name and type you specify. 


If COT is not running, the command with this option specified 
starts COT with a log file of the specified name and type. 


No console terminal is assigned. 


Description 
>SET /NOLOGFILE 


This command terminates writing to the log file. It does not 
open a new log file. To start writing to a new log file, use the 
appropriate SET command. 


C.2.3 Commands that Control Both the Console and the Log File 


The following commands control both the console and the log file _ to 
which messages are sent. 


>SET /COLOG=[TTn:] [ddnn:] [[uic]] [filename.filetype] 


>SET /NOCOLOG 


Description 
SET /COLOG 


If COT is not running, this command (without options) starts COT 
using the defaults terminal, device, UIC, and file 
specifications. You can use the options to specify the terminal, 
device, UIC, and log file that you want to use. 


If COT is running, this command (without options) displays’ the 
names of the log file and console terminal. 


If you enter any options with this command, while COT is running, 
you will get an error message. 

Options 

TTn: 


Specifies the console terminal. If you do not specify TTn:, COT 
sets the console terminal to TTO:. 


If COT is not running, the command with only this’ option 
specified starts COT, assigned to TTn:. The ddnn:, UIC, and 
filename.filetype options take the default value if you do not 
specify them. 
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ddnn: 


Specifies the device to which COT writes the log file. Use this 
option to change the device. 


If COT is not running, using the command with only this option 
specified starts COT using the default file specification of 
[1,4] CONSOLE.LOG on the ddnn: that you specified. Because only 
this option is present, COLOG sends messages to TTO: 
[uic] 
Specifies the UIC to which COT writes the log file. If you do 
not specify a UIC with the device ddnn: or filename.filetype, 
COT uses the default value of [1,4]. The brackets must be used. 
filename. filetype 
Specifies the file name and file type for COT to use when writing 
messages to the log file. If you do not specify the file name 


and file type, COT uses the default file specification of 
CONSOLE.LOG. 


Description 
>SET /NOCOLOG 
This command terminates COT. Before COT exits, it redirects CO: 


to TTO:. However, if it cannot redirect CO: to TT0O:, COT sets 
CO: offline and exits. 


C.3 CONSOLE OUTPUT TERMINAL ERROR MESSAGES 
The following section lists the error messages COT can return, along 
with their causes and user response, where possible. Messages appear 
at the last terminal that issued a COT command. 
COT -- CONSOLE TERMINAL ASSIGN ERROR 
Explanation: An error occurred when COT attempted to assign a 
new console terminal. The error may be the result of specifying 
an incorrect terminal unit number. 
User Action: Reenter the command with a new terminal number. 


COT -- UNABLE TO SPECIFY AST, COT EXITING 


Explanation: COT was unable to specify an AST for receiving SET 
commands from MCR. COT exits after displaying this message. 


User Action: The probable cause of this error is an attempt to 
run COT on a system that does not include AST support. 


COT -- FILE OPEN ERROR, FCS nnn 


Explanations An error occurred when COT tried to open a log 
file. The FCS error code is nnn and is printed as part of the 
message. 


User Action: Correct the problem designated by the FCS error 
number and restart the log file. 


4 
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COT -- FILE WRITE ERROR, FCS nnn 


Explanation: An error occurred when COT tried to write to an 
existing log file. The FCS error code is nnn and is printed as 
part of the message. 

User Action: Correct the problem designated by the FCS error 
number. If the problem caused output to the log file to be 


stopped, restart output to a log file with the appropriate SET 
command. 


COT -- NOT LOGGING ON A TERMINAL OR TO A FILE, COT EXITING 


Explanation: This message is displayed if a SET /NOCOTERM or SET 
/NOLOGFILE command causes all message handling to be turned off. 


User Action: Because COT exits after printing this message, 
restart COT with the appropriate SET command. 


COT -- UNABLE TO REDIRECT CO: TO TTO: 


Explanation: COT was unable to legally redirect CO: to TTO: 
when exiting. COT sets CO: offline when this occurs. 


User Action: None. 
COT -- CO READ ERROR 


Explanation: An error occurred when COT tried to read from CO:. 
This is an informational message only. 


User Actions None. 
COT -- SYNTAX ERROR 


Explanation: COT detected a syntax error when parsing a command 
line. 


User Action: Check the syntax and reenter the command. 
COT -- DRIVER NOT LOADED, COT EXITING 


Explanation: The console driver was not loaded. COT cannot 
operate properly and exits. 


User Action: If console driver support and loadable driver 
Support were requested during system generation, the console 
driver must be loaded. COT can then be restarted with the 
appropriate SET command. 


COT -- MAX CONSECUTIVE READ ERRORS, COT EXITING 


Explanation: An error occurred on 10 consecutive read operations 
when COT was trying to read from CO:. The probable cause is a 
system failure external to COT. COT exits after displaying this 
message. 


User Action: Determine the problem that caused the excessive 
read errors and correct it. Then restart COT. 


coT 


SET 


SET 


SET 


SET 


SET 


SET 
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-- MAX CONSECUTIVE WRITE ERRORS, DISABLING LOGFILE 

Explanations An error occurred on five consecutive write 
operations to the log file. COT attempts to close the log file 
and disables logging to the log file. 


User Action: Determine the problem that caused the write errors 
and correct it. Then restart message logging to the log file. 


-- INVALID KEYWORD 

Explanation: MCR received an illegal SET command. 

User Action: Check the command syntax and retry the command. 
-- PRIVILEGED COMMAND 


Explanation: COT can only be run or changed from a _ privileged 
terminal. 


User Action: Log in with a privileged account and reenter’ the 
command. 


-- MORE COMMAND PARAMETERS THAN PERMITTED 


Explanations More parameters are specified on the command line 
than are allowed for the command. 


User Action: Check the command parameter syntax and reissue’ the 
command. 


-- FILE SPECIFICATION EITHER INVALID OR NOT SPECIFIED 


Explanation: An invalid RSX-11M file specification was found in 
the command file. 


User Action: Reissue the command with a valid file 
specification. 


-- DEVICE NOT IN SYSTEM 


Explanation: The device name specified in the command is not a 
part of the current system. 


User Action: Check the system device table and reissue the 
command with the correct device name. 


-- YOU DO NOT HAVE THE PRIVILEGE TO ISSUE THIS COMMAND 


Explanation: The command you issued can be executed only from a 
privileged terminal. 


User Action: Log on to a privileged account and reissue the 
command. 


~*~ 


APPENDIX D 


THE QUEUE MANAGER 


This appendix is directed to the system manager or operator who is 
setting up and running the Queue Manager on an RSX-11M system. Except 
where noted, all commands described here are privileged. 


Most large systems will include the Queue Manager for the convenience 
of multistream line printer spooling. If not, the Serial Despooler, 
PRT..-, can be installed instead. Note that the Queue Manager 
includes QMGPRT, which installs as PRT..., to intercept output from 
the PIP /SP switch and other utilities and system tasks. See the 
RSX-11 Utilities Manual for more detail. This choice is made at 
SYSGEN. 


This chapter consists of a narrative introduction and review. of the 
process of setting up the Queue Manager, detailed descriptions of all 
commands to the Queue Manager, and a listing of an indirect command 
file to be included in the system STARTUP procedure as a reference 
example. 


D.1 NARRATIVE INTRODUCTION AND REVIEW 
Here is the procedure for bringing the Queue Manager into the system. 


This can be done interactively, but in most cases it iS more 
convenient to include it in an indirect command file invoked as part 
of the system's STARTUP procedures. 


Note that this procedure must be adapted for each installation. The 
example is based on the procedure used for the RSX-11M development 
system. QUE setup commands allow considerable flexibility in setting 
up the Queue Manager system. Dynamic alteration of the Queue Manager 
is also permitted. 


l-Install the Queue Manager. It is found with the privileged 
utility tasks. 


INS QMG/PRI=70 
2-Install the output despooler task (print processor). 
INS LPP/PRI=70 


This task installs automatically as LPPO. You must install this task 
for each physical device under the direction of the Queue Manager. 
This task “owns" the output device and must have a name based on the 
name of the device. Thus, the output despooler for LPl: must be 
installed under the name LPPl, using the TASK= option. There can _ be 
up to 15 output devices controlled by the Queue Manager. 
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INS QMGPRT 
This task installs automatically as PRT... and is the interface to 
PIP and other tasks that use PRINTS or .PRINT. The Queue Manager can 
then accept jobs from the PIP /SP switch. Although this task has’ the 
same name as the Serial Despooler used on previous versions of RSX-11M 
(and available on V3.2), it is not the same task. It replaces this 
task.) 


4-Install the Print Command Line Interpreter and the Queue Command 
Line Interpreter. 


INS QMGCLI/TASK=...PRI 
INS QMGCLI/TASK=...QUE 


The same task parses both the PRI and QUE commands and therefore must 
be installed twice, once under each name. 


5-Start the Queue Manager. 
QUE /START:QMG 


This command starts the Queue Manager and initializes the default 
queue PRINT. It creates the queue file QUEUE.SYS on SY¥:[1,7] if it is 


not there. The command also clears all assignments’ previously 
recorded. If the queue file was intact, all queues will still contain 
their jobs, but are not assigned to print processors. (Processors 


will have to be spooled again.) 
5-Spool the processor. 
QUE LP: /SPOOL/FLAG:1/FORM:0 


This command creates a queue LPQO (if it does not already exist) and 
starts the previously installed despool task LPPO. This task attaches 
device LPO: for despooling. Queue LPQO is assigned to despooler 
LPPO. Repeat this step for each output device under control of the 
Queue Manager. 


The /FORM switch establishes this attribute of the despooler. This 
means the despooler accepts jobs initiated by Print commands with the 
same /FORM attribute given. Jobs with other /FORM attributes remain 
in the queue until a despooler with the proper /FORM attribute is 
available. 


The /FLAG switch sets the default number of flag pages that precede 
each job. If users specify /FLag in their Print commands, each file 
in the job will be preceded by this many file flag pages as well. 


6-Assign the default queue to processors. 


QUE LP: /ASSIGN:PRINT 


This command assigns the default queue PRINT to processor’ LPPO. 
Normally, only the PRINT queue has to be assigned. Device-specific 
queues are assigned to their device despoolers by /SPOOL. This 
assignment of device-specific queues is a default, however, and not a 
requirement. A device-specific queue must exist for every spooled 
device, but these queues also can be assigned to other devices. 
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You can assign a queue to more than one processor and you can assign 
more than one queue to a processor. You can assign a device-specific 
queue to another device if necessary. For example, if printer LPO: 
is temporarily unavailable, you could assign LPQO to LPl:. 


D.2 REFERENCE EXAMPLE 


Here is a listing of SY:[{1,2]QMGSTART.CMD from the RSX-11M development 
system: 


INS DBO:QMG/PRI=70 

INS DSO:LPP/PRI=70 

INS DSO: QMGPRT 

INS DSO: QMGCLI/TASK=...PRI 

INS DSO: QMGCLI/TASK=...QUE 

QUE /START:QMG 

QUE LP: /SPOOL/FLAG: 1/FORM: 0 
QUE LP: /ASSIGN:PRINT 


D.3 QUEUE MANAGER COMMAND DESCRIPTIONS 


Setting up the Queue Manager is controlled through a number of 
privileged functions applied to the QUE command. 


The format of the Queue Manager setup commands is: 
>QUE ddnn:/function[:option[s]] [/sw[s]] 
Where: 
ddnn: is the device name. 
7function is the function to be performed. 
s:option is the option for that function [may be more than one]. 
/sw is the switch for that option 
These commands allow a privileged user to attach or detach devices for 


spooling, start and stop devices, assign the default queue to devices 
and start and stop the Queue Manager. 


D.3.1 STOP 
This function suspends a device or stops the Queue Manager. 
>QUE ddnn: /STOp[: option] 
EOF 
EOJ 
>QUE /STOp: QMG 
ddnn: 


The device name is required with all options except /STO:QMG. 
You cannot include a device when stopping the Queue Manager. 
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option 


If you do not enter an option (null option) the device stops 
immediately. This is a pause. 


EOF 
The device stops at the end of the current file. 
EOJ 
The device stops at the end of the current job. 
/STO:QMG 
The Queve Manager stops at the end of the current job. All 
assignments of queues to devices are broken (deassigned). All 
despooler tasks are detached from their devices. The Queue 
Manager exits. 
Examples: 
>QUE LPO:/STOP 
This example stops printing on LPO:. No jobs will be taken’ from 
queues assigned to the device, but jobs can still be added to 
queues. 
>QUE LP2:/STO:EOJ 
This example stops printing on LP2: at the end of the active 
job. 
>QUE /STOP: QMG 
This example stops the Queue Manager. QMG is marked for stop and 
the current jobs are allowed to finish. 
D.3.2 START 
This command starts printing on a previously stopped device or starts 


the Queue Manager after a STOP. This command counteracts STOP. 


ddnn: 


>QUE ddnn:/STArt[:option] [/sw] 
NExt /FOrm:n 
TOP /FLag:n 
PAge:n 
BAckK:n 


FOrward:n 


>QUE /STArt:QMG 


A device name is required with all options except /STA:QMG. You 
cannot include a device when starting the Queue Manager. 


d 


ad 
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option 


NExt 


TOP 


Option and switch are mutually exclusive fields. Use one or the 
other. 


If you enter nothing (null option), the device starts printing 
from the point at which printing stopped. This, in effect, 
resumes printing after a pause. 


Printing starts at the top of the next job. 


Printing starts at the top of the current file. 


PAge:n 


BAck: 


Printing starts at page n of the current file. 


n 


Printing starts n pages back from the point at which it was 
stopped. 


FOrward:n 


Printing starts n pages forward from the point at which it was 
stopped. 


STA:QMG 


This option is entered without ddnn: as it starts the Queue 
Manager and initializes the default queue PRINT. It creates the 
file SY:{1,7]QUEUE.SYS if it is not there. The command also 
clears all assignments’ previously recorded. If the queue file 
was intact, all queues still contain their jobs, but are not 


assigned to processors. (Processors will have to be spooled 
again.) 

/Sw 
The switch and option fields are mutually exclusive. Use one or 
the other. You can enter more than one switch, however. 

/FOrm:n 
This switch resets the forms type of the despooler task from the 
type set with SPOOL. 

/FLag:n 


This switch resets the default number of flag pages set with 
SPOOL. Print jobs have n job flag pages preceding the job. If 
users specify /FLA in their print command, each file in the job 
will also be preceded by n file flag pages in addition to the job 
flag pages. n can be 0, 1,2, or 3. 


If you are using special forms in your printer, you should set 
n=0 so that no flag pages are printed on your special forms. 
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Examples: 
>QUE LPO:/STA 
Start LPO:; printing proceeds from where it was stopped. 
>QUE LP2:/START:NE 
Start printing with the next job queued to LP2:. 
>QUE LP:/STA/FO:11 | 
Start printing on LPO: with FORMS attribute reset to 1l. 
Notes: 


Page-related options have no effect unless the user specified a 
LEngth:n quantity in the Print command. 


If restarting a processor to handle special forms types, you may 
want to set FL to 0 to avoid printing banner pages on your 
special forms. 


D.3.3 SPOOL 


This function attaches a device for despooling. The command starts a 
despool task, optionally creates a queue named after it, and assigns 
the queue to the despool task. 


>QUE ddnn:/SPool/sw 


SPOOL creates queue ddQn (if it -does not already exist) and 
Starts the despool task ddPn which must be installed previously 
for device ddn. This attaches device ddnn: for despooling by 
the despool task ddPn open to jobs from queue ddQn. 


/sw 
More than one switch can be used with this function. 
/FOrm:n 
Sets the device despooler to accept jobs with forms type n. 
You can set a despooler to accept more than one forms type, but 
the forms definition nust be duplicated. 
n 


This number can be anything from 0 to 255. The default is 0. 


These numbers are to be specified by your users in their Print 
commands. 


If the right forms are not in an available printer, then their jobs 
will be waiting until the printer has been stopped, the proper forms 
put in place, and the printer restarted using the /FORMS: qualifier 
and the proper value for n in the START/ command. 


Forms differ by their length and width. Both values can be set in the 
forms table. 


% 
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Setting width is simply a matter of how many columns are needed to 
fill in the form. There are no standard widths for forms, but 80. 
and 132. are the most common. 


Setting length requires you to determine whether your forms are of a 
Standard length. 


"Standard length" is any form length that can be set on your printing 
hardware. If the hardware can handle the form by setting a response 
to a form-feed character <FF>, then it is a standard length form, and 
the form-feed is a "real", i.e., hardware, form-feed. 


If the form length cannot be set on the hardware, then it is a 
non-standard length. In this case, the form-feed <FF> must be 
replaced by an appropriate number of line-feeds <LF>. This is called 
a “simulated", i.e., software, form-feed. 


You should determine which forms are used on your system and assign 
each a number. This number points to a table of form definitions. 
The form definitions consist of a single 16-bit word. The length is 
the low-order byte and the width is the high-order byte. The high bit 
of the length byte is set when simulated forms (forms whose length 
cannot be set on your hardware) are needed. This form definition word 
can be changed by editing the Task Builder command file for’ the 
despooler’ task. You must add a global patch statement of the 
following form: 


TKB>GBLPAT=INIT: FRMTBL+k: value 


where k is the assigned form number multiplied by 2 (n*2) and value is 
the form definition word (value = width + <200*SIMFF> + <width*400>). 


The following table shows the forms requirements for a hypothetical 
installation. The form names describe different uses that special 
forms might be put to, but have no significance otherwise. 


FORM ASSIGNED n WIDTH LENGTH SIMFF 
Accordion 0 132 66 N 
Paychecks 1 40 10 N 
Invoices 2 80 66 N 
Stationery 3 80 66 N 
Moon Diary 4 22 43 Y 
Star Log 5 112 113 4 


(As shipped, FORMS:0 is 66 lines long by 132 columns with real 
form-feeds. FORMS:1 is 1 line long by 132 columns with simulated 
form-feeds; FORMS:2 is 2 lines long by 132 columns with simulated 
form-feeds; and so- on through FORMS:66 which is 66 lines long by 
132 columns with simulated form-feeds. The remaining FORMS:n 
entries are set to 1 line long by 132 columns with simulated 
form-feeds. Thus, if you specify FORMS:43, when the printer 
encounters a form feed, it counts the number of lines on the page 
and subtracts that number from 43. The printer then reels off a 
number of line feeds equal to the difference. You may find this 
arrangement satisfactory if your installation rarely uses forms 
other than standard line-printer paper, but if you have more than 
one standard form, you will probably want to make the changes in the 
forms table entries.  ) 


/FLag:n 


Sets the number of flag pages to precede all jobs printed on the 
device. Note that if you are using special forms, you may want to 
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set this attribute to 0 to avoid printing banner pages on your 
special forms. This also sets the number of file flag pages to be 
printed when users specify the FLAGS switch in their Print commands. 
Examples: 

>QUE LPO:/SPOOL 

Attach LPO: for despooling. 

>QUE LP3:/SP/FO:2 


Attach LP3: for despooling with forms set to 2. 


D.3.4 UNSPOOL 
This function removes a device from despooling. The device no 
longer is assigned to queue. The despooler task exits. The 
associated device-specific queue is not deleted. 

>QUE ddnn:/UNSPool 
UNSPOOL frees a device used in despooling for general use. The 
despool task for the device exits but its entries in queues assigned 
to it remain in the queue file. 
Example: 

>QUE LPO:/UNSP 


This example removes the device LPO: from active use by the 
despooler LPPO and the Queue Manager. 


D.3.5 ASSIGN 
This function creates a path between a queue and a despooler. 
>QUE ddnn: /ASsign: queuename 


ASSIGN is normally used to assign the default queue PRINT to one or 
more despooler tasks, but you can assign any queue to any despooler. 


Example: 
>QUE LPO:/AS:PRINT 
Assign PRINT queue to LPO:. 
Notes: 
Remember that SPOOL automatically assigns a device-specific 


queue to its related device. For example, LPQ1 is 
automatically assigned to LPl:. 


aa 
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D.3.6 DEASSIGN 
This function breaks the assignment of a queue to a despooler. 
>QUE ddnn:/DEAssign:queuename 
DEASSIGN eliminates the path between a queue and a despooler, but 


the queue still exists with all its jobs. Jobs can be added to the 
queue, but none will be dequeued while the queue is not assigned. 


APPENDIX E 


THE RSX-11M I/O EXERCISER 


E.1 INTRODUCTION 


The RSX-11M I/O Exerciser (IOX) is a software tool that you can use to 
diagnose hardware and software I/O problems. IOX is intended for use 
by system managers, system operators, and system programmers who want 
to test units in a hardware configuration to determine whether these 
units are correctly executing I/O operations. In addition, IOX allows 
you to measure system activity. 


IOX provides a command language for executing test functions. IOX 
output consists of detailed error reporting and general information 
describing system activity. 


You should be familiar with information in the following publications 
to effectively use IOX: 


e RSX-11M/M-PLUS Error Logging Reference Manual 


e RSX-11M/M-PLUS MCR Operations Manual 
e@e RSX-11 Utilities Manual 


E.1,1 What IOX Does 


The I/O Exerciser (IOX) tests the I/O units in your configuration to 
ensure that they correctly execute I/O functions. 


IOX exercises I/O units on your system by writing a data pattern to a 
volume on a eunit and reading the data that was written. IOX then 
checks to ensure that the pattern read matches the pattern written. A 
mismatch between the written pattern and the pattern being read 
indicates an error. IOX reports errors when they are encountered. 
IOX also displays activity reports at specifed intervals and at the 
completion of an I/O exercise. 


IOX has a command language that you can use to direct I/0 exercise 
functions. IOX provides commands to: 


e Set up units in a test configuration 
e Select specific units to be tested 


e Set I/O exercise execution conditions 
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e Control I/O exercise execution 


e Direct command lines to RSX-11M for execution during an 
exercise 


e Measure system activity using the IOX idle loop 
Section E.2 summarizes, in alphabetical order, the IOX commands. For 


complete command descriptions, including formats and usage rules see 
Section E.10. 


E.1.2 Setting Execution Conditions 


IOX execution-time parameters allow you to set conditions under’ which 
an I/O exercise executes. You set these parameters using commands to: 


e Specify the number of I/0 errors I0X tolerates before 
deselecting a unit 


e Set the length of time between interval summary reports 
e Direct summary reports to the log file IOX.LOG 


e Specify the size of the temporary file IOX uses when it 
exercises a unit containing a Files-ll-formatted volume 


e Specify the size of the buffer I0X uses when it exercises 
units containing non-file-structured volumes 


For more information on how to use the IOX execution-time parameters, 
see Sections E.3.4 and E.5. 


E.1.3 Controlling the I/O Exercise 


IOX commands allow you to control execution of an I/O exercise. Using 
execution control commands you can: 


e Interrupt execution of an I/O exercise to enter IOX commands 
interactively 


e Abort execution of an I/O exercise or a task 
e Deselect units from the test configuration 


@e Display current execution status, parameter settings, and 
summary information 


e Modify execution parameters 


@® Restart IOX 
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E.1.4 Devices Supported by IOX 


The following is a list of devices supported for IOX: 


Device Abbreviation 
RP04/RP05/RP06 DB: 
TUS8 DD: 
RF11l DF: 
RKO5/RKOSF DK: 
RLO1/RLO2 DL: 
RKO6/RKO7 DM: 
RPO 2/RPRO2/RP03 DP: 
RM0 2/03 DR: 
RS03/RS04 DS: 
RXO1 DX: 
RX02 DY: 
TU60 CT: 
TU56 DT: 
TU1L6/TE16/TU45/TU77 MM: 
TSO04 MS: 
TU1O/TE10/TSO3 MT: 


E.2 SUMMARY OF IOX COMMANDS 


Table E-1l is an alphabetical list of IOX commands with a summary of 
the functions each provides. 


Table E-1l 
Summary of IOX Commands 


Command Description 
ABORT Terminates execution of an I/O exercise before 
normal completion 


ABORT taskname | Terminates execution of a task initiated by the 
, EXECUTE command 


ABORT /ALL Terminates execution of all tasks initiated by the 
EXECUTE command 


BADBLOCKS Enters the numbers of bad blocks in the IOX bad 


block list; displays the blocks in the bad block 
list 


BUFFERSIZE Sets the default size of the buffer IOX uses to 
. write and read when exercising a unit with a 
non-file-structured volume 


CONFIGURE Adds a unit to your test configuration; displays 
the units in your test configuration 


CONTROL C Enables or disables the interruption of an _ I0OX 
exercise to enter a command interactively 


(continued on next page) 
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Table E-1 (Cont.) 
Summary of IOX Commands 


Sets the tape density for magnetic tape testing; 
displays the current or default density and 
characteristics word 


Command 


DENSITY 


DESELECT 


Terminates testing on a unit 


ERRORLIMIT Sets the number of errors tolerated before IOX 


deselects a unit 


EXECUTE Directs a command line to the operating system for 


execution 


EXIT 


Exits from IOX to the operating system monitor 


FILES11 Selects a unit with a Files-11 volume mounted; 
directs IOX to protect the volume data structure 


during an I/O exercise 


HELP Displays a summary description of IOX commands at 


your terminal 


INTERLEAVE Sets the block interleave factor for disk testing 


ITERATIONS Sets the number of times through the IOX idle loop 


for the idle loop iteration count 


LOGFILE Directs activity reports and error reports to 


either your terminal or the log file IOX.LOG 


PARAMETERLIST 


Displays the current settings for IOX parameters 


PATTERN Sets the test pattern IOX writes and reads during 


testing; display all test patterns 


PRINTSUMMARY Displays a Summary report of IOX activity at your 


terminal 


PROCEED Resumes IOX test execution after it has’ been 


interrupted by CTRL/C in interactive mode 


RANDOM Enables or disables testing of random blocks 


rather than sequential blocks during testing 


REPORTERRORS 


Enables or disables error reports directed to your 
terminal 


RESTART Reinitializes IOX: stops testing, deconfigures 
all units except default units, deselects all 
units, and resets all parameters to their default 


values 


RETRIES Enables or disables retries of I/O operations by 


I/O drivers detecting I/O errors 


RUNTIME 


Sets the length of time IOX is to test units 


(continued on next page) 
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Table E-1 (Cont.) 
Summary of IOX Commands 


Command Description 
SELECT _ Selects a-unit with a non-file-structured volume 
for an I/O exercise 


SPY Displays execution-time information for a specific 
unit or for all selected units 


START Begins an I/O exercise on selected units in your 
configuration 


SUMMARY TIME Sets the time interval between interval summary 
reports 


TEMPORARYFILE Sets the size of the temporary file IOX uses to 
exercise units with Files-11 volumes mounted 


VERIFY Ensures that data can be read from a unit 


VOLUMECHECK Checks to determine whether a unit to be tested 
has a Files-1ll volume mounted 


WAIT Specifies the algorithm IOX executes in its idle 
loop 


WRITECHECK Enables or disables write checks to disks 


E.3 INSTALLING, INVOKING, AND RUNNING IOX IN AN EXERCISE EXAMPLE 
This section uses an example of a terminal session to show you how to 
install and invoke I0X, set up your test configuration, set up 


execution-time parameters, select units you want to exercise, and 
Start the I/O exercise on those units. 


E.3.1 Installing IOX 


If IOX is not installed on your system, install IOX by using tthe MCR 
INSTALL command: 


>INS SIOX/INC=nn 
where: 
nn is 1.2K words per device to be tested. 


If your Executive was built with the Extend Task directive included in 
it, you need not specify the INC keyword. 


The Task Builder command file for IOX built IOX as a nonprivileged 
task that is checkpointable and that runs at a priority of 50(10) in 
the GEN partition. 
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E.3.2 Invoking IOX 


If IOX is installed on your system, invoke it with the command: 


>IOXxX 


IOX responds by prompting you with the task name assigned by the 
operating system: 


IOX> 


When you receive this prompt, you can enter IOX commands. 


If IOX is not installed on your system, you can invoke it with the MCR 
RUN command: 


>RUN S$IOX/INC=nn 
where: 
nn is 1.2K bytes per device to be tested. 


If your Executive was built with the Extend Task directive included in 
it, you need not specify the INC keyword. 


In this case, IOX names the task using your terminal number and 
prompts you using this task name. For example: 


TT36> 


When you receive this prompt you can enter IOX commands. 


E.3.3 Setting Up Your Test Configuration 


All units have unit number 0 included in the IOX test configuration by 


default. You must explicitly configure any other units you want to 
exercise. For example: 


IOX>CONFIGURE DK1: 
IOX>CONFIGURE DK2: 
IOX>CONFIGURE MM5: 


E.3.4 Setting Up Execution-Time Parameters 


You can set conditions that affect the execution of the I/O exercise. 
For example, you can specify the length of exercise execution time, 
how often you want a report of exerciser activity, and whether you 
want the activity reports directed to the log file SY0:IOX.LOG. You 
can also request IOX to determine whether the units being tested have 
Files-1l1 volumes mounted. 


The following commands are an example of how to set up execution-time 
parameters for an I/O exercise: 


IOX>RUNTIME 10 
IOX>SUMMARYTIME 4 
IOX>LOGFILE YES 


These commands direct IOX to execute the I/O exercise for 10 minutes, 


generate an interval report every four minutes, and direct all reports 
to the log file. 
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E.3.5 Selecting Units for an I/O Exercise 


Once you have set up your test configuration, you can select units’ to 


be tested. Only units you explicitly select are exercised For 
example: 


IOX>FILES11 DK1l: 


This command selects unit DK1: for exercising. When IOX executes, 
only DKl: is exercised. You can use either the SELECT command or the 
FILES11 command to select a unit for exercising. The FILES11 command 
is used in this example because it protects the file structure ona 
Files-1l1 volume during an I/O exercise. 


E.3.6 Starting an IOX Exercise Execution 


After setting up your configuration and selecting the units you want 
exercised, begin the I/O exercise by entering the START command: 


IOX>START 


IOX then performs pattern checking on DK1l: for the length of time you 
specified with the RUNTIME command (10 minutes). ‘When IOX completes 
execution, it generates a summary report and the interval reports, and 
directs them to the log file IOX.LOG. You can gain access to and 
examine the log file after you exit from IOX by entering the command: 


>PIP TI:=IOX.LOG 


This command directs the PIP utility to display the file at your 
terminal. 


E.3.7 Exiting from IOX 


You can exit from IOX and return control to the operating system 
monitor by using the EXIT command: 


IOX>EXIT 


E.4 IOX OPERATIONAL MODES 


IOX operates in three modes: command, execution, and interactive. 
Operational modes are controlled by means of CTRL/C and carriage 
return on your terminal keyboard. 


In most cases, CTRL/C causes RSX-11M to interrupt a task and give 
control to MCR, the keyboard monitor. You then receive the MCR prompt 
(>) at your terminal. 


However, by entering the CONTROL _C command, IOX allows you to use 
CTRL/C in an alternate way: you can use CTRL/C to interrupt an IOX 
I/O exercise and give control to IOX rather than to MCR. 


This section describes the operational modes and how to use the _ I0OX 
CONTROL_C command to control them. 
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E.4.1 Command Mode 


When you invoke IOX by entering the command line described in Section 
E.3.2, "Invoking IOX," IOX is in command mode waiting for you to enter 
a command. When you press carriage return in command mode, I0OX 
prompts yous 


IOX> 


When you enter CTRL/C in command mode, RSX-11M issues the MCR- prompt 
and the normal rules for entering commands to MCR apply. 


In command mode, you can use the CONTROL_C command to enable or 
disable interruptions to an I/O exercise. CONTROL _C YES enables 
interruptions, allowing you to enter commands interactively; 
CONTROL _C NO disables interruptions to an I/O exercise. 


E.4.2 Execution Mode 


When you begin an I/O exercise (by means of the START command), I0OX 
enters execution mode. 


If you have enabled interruptions to the I/O exercise by means of 
CONTROL_C YES, I0X will not accept any input from your terminal except 
CTRL/C. If you try to enter any other input, IOX responds with the 
message: 


IOX -- ONLY “C ALLOWED 


If you have disabled interruptions to the I/O exercise by means of 
CONTROL _C NO, CTRL/C causes RSX-11M to issue the MCR prompt and 
execution of the I/O exercise continues. In this case, execution of 
the I/0 exercise cannot be interrupted. 


E.4.3 Interactive Mode 


When CONTROL _C YES is set, you can interrupt an I/O exercise to enter 
commands interactively. When you enter CTRL/C, IOX prompts you: 


IOX> 


When you receive this prompt, you can enter any IOX command except the 
following: 


BUFFERSIZE 

PATTERN (PATTERN with no arguments is permitted) 
RUNTIME 

RESTART 

START 


These five commands must be entered in command mode. 


CTRL/C places IOX in interactive mode until you enter PROCEED. In 
interactive mode, the I/0 exercise continues to execute, but error 
reports and activity reports directed to your terminal (if LOGFILE NO 
is set) are suspended until you enter PROCEED. If you set LOGFILE 
YES, error reports and activity reports are generated normally. 
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CTRL/C halts the IOX clock so that even though the I/0 exercise is 
continuing, it is not being timed by the IOX clock. Consequently, the 
exercise may run longer than you specify in the RUNTIME command. 


E.5 SETTING EXECUTION-TIME PARAMETERS 


Many IOX commands set IOX execution-time conditions, such as how long 
IOX executes, time between Summary reports, and so forth. The 
PARAMETERLIST command displays all execution-time parameters and_ the 
value of their current setting. For example: 


IOX>PARAMETERLIST 

BUFFERSIZE= 1024. CONTROL C=YES 
ERRORLIMIT= 10. LOGFILE= NO 
INTERLEAVE= 4. RANDOM= YES 
ITERATIONS= 10. REPORTERRORS= YES 
PATTERN= 4. RETRIES= NO 
RUNTIME= 5. VOLUMECHECK= YES 
SUMMARYTIME= 1. WAIT= YES 
TEMPORARYFILE= 500. WRITECHECK= NO 


DYNAMIC MEMORY USAGE= 3278.:2248.:2248.:1. 


There are five categories of execution-time parameters. These 
parameters are controlled by commands that: 


e Set general execution-time conditions 
e Set execution-time conditions for units with Files-1l volumes 


e Set execution-time conditions for units with 
non-file-structured volumes 


e Set execution-time conditions for measuring system activity 


e Direct the operating system to execute non-IOX tasks 


The following sections describe the commands in each of these 
categories. 


E.5.1 Setting General Execution-Time Conditions 


General execution-time commands affect the execution of all I/0 
exercises. You are likely to want to set these commands each time you 
run IOX; therefore, you may want to put them in an indirect file. 


LOGFILE Allows you to direct IOX activity reports to a log 
file, IOX.LOG 

RUNTIME Allows you to set the length of time an I/0 exercise 
is to execute 

SUMMARYTIME Sets the time interval between interval summary 
reports 

ERRORLIMIT Sets the number of I/O errors IOX tolerates before it 


deselects a unit from the test configuration 


REPORTERRORS Enables or disables error reporting 
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CONTROL_C Enables or disables interruptions to an I/O exercise 


PATTERN Sets the test pattern IOX writes and reads_ when 
exercising a unit 


E.5.2 Setting Execution Conditions for Units with Files-1l Volumes 


To set execution conditions for units with Files-ll volumes. Use’ the 
FILES-11 and MTEMPORARYFILE commands. The FILES11 command selects a 
unit to be exercised; the TEMPORARYFILE command specifies the default 
size of temporary file IOX uses when it exercises the unit. You can 
override this default with the FILES11 command. 


Files-11 volumes are volumes formatted for use by the RSX-11M file 
system, Files-ll. These volumes’ have data structures such as home 
blocks, directories, and boot blocks on them. The FILES11 command 
selects a unit with a Files-11 volume and allows you to exercise the 
unit without destroying the data structures or files on the volume. 


IOX uses a temporary file when it exercises a unit with a Files-ll 
volume. IOX creates the temporary file on the volume to be tested and 
marks the file for deletion. IOX then selects a random block in the 
temporary file to exercise. Because the temporary file is marked for 
deletion, it is erased from the disk's file structure when the 
exercise completes or IOX terminates. 


E.5.3 Setting Execution Conditions for Non-File-Structured Volumes 


To exercise units with non-file-structured volumes, use the SELECT 
command. The SELECT command does not check for any of the Files-1l 
data structures; it exercises the entire volume, destroying all data 
on the volume. 


Use the VOLUMECHECK command (VOLUMECHECK YES) to ensure that the 
volume on the unit you select does not contain any Files-1l data 
Structures. VOLUMECHECK directs IOX to warn you if it finds such 
structures on what you think is a non-file-structured volume. 


You may set four execution conditions when you exercise units with 
nonfile-structured volumes: the default buffer size, the pattern 
checking method, the bad block locations, and whether IOX performs 
certain I/O operations during the exercise. 


E.5.3.1 Setting the Default Buffer Size - Use the BUFFERSIZE command — 


to change the default size for the buffer IOX uses when it does 
pattern checking. When you invoke IOX, the default buffer size is 
1024. You can override any default you set when you enter SELECT with 
another buffer size. 


E.5.3.2 Choosing a Pattern-Checking Method - IOX can exercise a unit 
by writing to and reading from either random blocks or sequential 
blocks on a volume. You can control the pattern-checking method with 
the RANDOM and INTERLEAVE commands. 


If you specify RANDOM YES, IOX exercises randomly selected blocks’ on 
the volume. 


THE RSX-11M I/O EXERCISER 


If you specify RANDOM NO, IOX exercises sequential blocks on _ the 
volume, beginning with block 0. IOX adds the interleave factor to the 
location of the last block exercised and uses the result of the 
addition to determine the next block to exercise. For example: 


RANDOM NO 
INTERLEAVE 1000. 


These commands direct IOX to begin at block 0O and perform pattern 
checks on blocks 0, 1000, 2000, and 3000. 


E.5.3.3 Entering Bad Block Locations - Use the BAD BLOCKS command to 
enter the locations of known bad blocks (that is, bad blocks located 
by the RSX-11M BAD utility) on a volume. IOX maintains a list of bad 
blocks and ignores them during an I/O exercise. IOX allows you to 
enter the locations of bad blocks manually; you must know where- such 
blocks are on the disk to use this command effectively. See the 
description of the BAD BLOCKS command in Section E.10 for information 
on how to enter the locations of bad blocks. 


E.5.3.4 Controlling I/O Operations During the I/O Exercise - Use’ the 
RETRIES and WRITECHECK commands to disable certain I/O operations 
during an I/O exercise. RETRIES NO directs an I/O driver to not retry 
an I/0 operation when it receives an error. WRITECHECK NO directs an 
I/O driver to not perform write checks on WRITE I/O operations. 


E.5.4 Setting Execution Conditions for Measuring System Activity 


IOX provides two commands for measuring system activity: WAIT and 
ITERATIONS. 


IOX executes an idle loop while it waits for units to complete I/0 
operations. It can execute either one of the following in this loop: 


1. The wait~-for-event-flag algorithm 
2. The instruction 
BICB -(SP),(SP)+ 


The BICB instruction takes a large amount of CPU time and can be used 
to measure I/O throughout. 


The wait-for-event-flag algorithm is the default, but you can disable 
it and execute the BICB instruction by entering the command: 


WAIT NO 


You can determine the exact execution speed of the BICB instruction on 
your processor by referring to the appropriate PDP-1l Processor 
Handbook. Using this information, along with the number of times IOX 
executes the instruction, as set by the ITERATIONS command, you can 
estimate the level of system I/O throughput. 


See the ITERATIONS command description in Section E.10. 


E.5.4.1 


for 
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The IOX Idle Loop Algorithm - The following code is provided 
to measure the instruction times in the IOX idle loop. This 
listing is the actual code in the IOX idle loop. 


BCKGND: :TST 


1s: 


58: 


10S; 
158: 


208: 
2583 


E.5.5 


BMI 


STOPFG 
30$ 


40S 
SITCNT,CNTI 
SDEQUE 
SWAIT 

20$ 

#WAIEFN 
#WAIEFN 
STOPFG 


25$ 

-(SP), (SP)+ 
CNTI 

15$ 

#1,CNTA 
CNTB 

CNTC 

BCKGND 


;TIME FOR INTERVAL REPORT? 

;IF MI YES 

;STAY IN INTERACTIVE MODE? 

;IF EQ NO 

7YES, ASSUME WE WILL LEAVE IT 
;DEQUEUE ALL PENDING DESELECTS 
;CALL INTERACTIVE COMMAND INTERPRETER 
; LOOP AGAIN 

7;ARE WE RUNNING? 

7IF MI NO, ABORT 

;SETUP ITERATION COUNT 
;DEQUEUE ANY PENDING DESELECTS 
;USE "WTSESS" INSTRUCTION? 

7IF EQ NO 

;WAIT FOR IOX TO DO SOMETHING 
;NOW CLEAR THE EVENT FLAG 
;TIME FOR INTERVAL REPORT? 

7IF MI YES 

7°C ACTIVE? 

;IF NE YES 

7GO COUNT ITERATIONS 

;WAIT 

;ALL FINISHED? 

7;IF GT NO 

;UPDATE IDLE LOOP COUNT 
RIPPLE CARRY 


; LOOP AGAIN 


Directing the Operating System to Execute Non-I0OX Tasks 


Use the EXECUTE command to direct commands to the operating system for 


execution. 


For example: 


This command 
the BAD utility. 


EXECUTE 


»»eBAD DK1:/LI 


These taskS execute concurrently with an I/O exercise. 


specifies that you want the operating system to execute 


You can use the PARAMETERLIST command to display the status of tasks 


you 


initiate 


using EXECUTE. 


See Section E.7, "Displaying I/O Status 


Information," for details on these status reports. You can use the 


ABORT 


command 


to 


tasks initiated by EXECUTE. 


E.6 


IOX generates 


reports. 


Activity 


I/O EXERCISE OUTPUT 


two types of 
reports 


output: 


terminate one (ABORT taskname) or all (ABORT /ALL) 


activity reports and error 
are summaries of IOX processing 


information, such as how long an I/O exercise has run and how much 


time 


remains 


for the I/O exercise to complete. Error reports show 


such information as the block where an I/O error was encountered. 
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E.6.1 Activity Reports 
There are three types of activity reports: 


e Summary report -- an activity report summarizing IOX activity 
for the entire I/O exercise 


e Interval report -- an activity report summarizing IOX activity 
in the time intervals set by the SUMMARYTIME command 


e Print summary -- a report displayed at your terminal 
summarizing the IOX activity in the interval between the last 
summary report and the time you entered the PRINTSUMMARY 
command. 


Using the LOGFILE command, you can direct IOX to display summary 
reports, interval reports, and error reports at your terminal or you 
can direct them to the log file IOX.LOG. The following lines show the 
general format of IOX activity reports. 


18-SEP-78 15:44:42 **##*kREe EXERCISER STARTED *#**44%% 
TIME -- RUN: 1 MIN. ELAPSED: 1 MIN. REMAINING: 0O MIN. 
DKO: -- 1,183. REQUESTS TOTALING 1,183. BLOCKS WITH NO ERRORS 
IDLE-LOOP COUNT: 724. ITERATIONS 


18-SEP-78 15:45:56 **##eeeee EXERCISER TERMINATED **** XXX 


As shown above, the output of activity reports consists of lines 
telling when exerciser events occured and lines containing status 
information. : 


The exerciser event lines tell you when the exerciser began execution, 
terminated execution, aborted execution, started a log file, and 
terminated entries to the log file. The following line is an example 
of a line describing an exerciser event: 


18-SEP-78 15:45:56 **¥**keek EXERCISER STARTED **¥**##*R% 
There are five types of status information lines: 
e General user information: date and time of report 


e Timing information: time between reports, total execution 
time (to the nearest minute), and remaining execution time 


e Unit information: number of I/O requests to the unit, number 
of blocks exercised, and number of errors encountered on the 
unit 


e Idle loop information: number of iterations through the idle 
loop 


e Error reports: see Section E.6.2 


Both summary reports and interval reports can be directed to either 
your terminal or the log file by means’ of the LOGFILE command. 
LOGFILE YES specifies that the summary information is directed to the 
log file; LOGFILE NO specifies that the summary information is 
displayed at your terminal. LOGFILE NO is the default. 


To generate a print summary, use the PRINTSUMMARY command. This 
report cannot be directed to the log file. The print summary shows 
the amount of IOX exercise activity in the interval between the last 
interval report and the time you entered the PRINTSUMMARY command. 


THE RSX-11M I/O EXERCISER 


E.6.2 Error Reports 


The following lines show the form of an IOX error report. At the same 
time IOX is reporting this information, if error logging is enabled, 
.the RSX-11M error logging program is also logging the error. For 
information on how the error logger handles the errors, refer to the 


RSX-11M/M-PLUS Error Logging Reference Manual. 


DK1: -- UNRECOVERABLE ERROR AT BLOCK 358 (DECIMAL) 546 (OCTAL) 
DK1: -- DATA ERROR AT BLOCK 358 (DECIMAL) 546 (OCTAL) 

GOOD DATA: 165555 BAD DATA: 167155 (OCTAL) 

WORD POSITION: 308 (DECIMAL) 464 (OCTAL) 


The error report comprises up to three lines. The first line tells 
you the block number (in decimal and octal) where the error was 
encountered. The second line tells "good data" and "bad data." The 
third line indicates the position of the word within the block (in 


decimal and octal) where the error was encountered. Only the first 
error encountered in the block is reported. 


E.7 DISPLAYING IOX STATUS INFORMATION 

IOX provides four commands for displaying status information: 
@ PARAMETERLIST - displays parameter settings 
e SPY - displays the status of a unit being tested 
e CONFIGURE - displays all devices in your configuration 


e PATTERN - displays all 11 IOX patterns 


E.7.1 Displaying Parameter Settings 


The PARAMETERLIST command displays the settings of IOX exercise 
parameters at the time you enter the command. The following lines 
show format of a PARAMETERLIST display. 


TASK STATUS COMMAND LINE 

eeeBAD QUEUED DKO:/LI 

DEVICE LUN BUFSIZE TYPE FILESIZE 
DB1: Ds 512. Fll 500. 
DB2: 6. 512. Fll 500. 
MM1: 7. 1024. NFS 

BUFFERSIZE= 1024. CONTROL _ C= YES 

ERRORLIMIT= 10. LOGFILE= NO 

INTERLEAVE= 4. RANDOM= YES 

ITERATIONS= 10. REPORTERRORS= YES 

PATTERN= 4. RETRIES= NO 

RUNTIME= 5. VOLUMECHECK= YES 

SUMMARYTIME= 1. WAIT= YES 

TEMPORARYFILE= 500. WRITECHECK= NO 


DYNAMIC MEMORY USAGE= 3278.:2248.:2248.:1. 
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For tasks initiated by the EXECUTE command, the PARAMETERLIST command 
displays: 
e The installed task name (...BAD) 


e The execution status (QUEUED, ACTIVE, SUCCESS, WARNING, ERROR, 
SV ERROR) 


e The command line elements you entered (DK0O:/LI) 
ACTIVE indicates that IOX is being executed. The remaining status 
indications relate to the Exit with Status (EXSTS$) Executive 
directive. For more information on these status indications, refer to 
the RSX-11M/M-PLUS Executive Reference Manual. 
For selected units, PARAMETERLIST displays the following information: 

e Device specifications (DBl:, DB2:, and MM1:) 

e Logical Unit Number (LUN) (5, 6, and 7) 

e Buffer size IOX uses for reads and writes (512(10) for units 

with Files-ll volumes; 1024(10) for units with 


non-file-structured volumes) 


e Type of volume mounted on unit (Fll for Files-1l; NFS for 
non-file-structured volumes; VFY for units being verified) 


e File size of the temporary file IOX uses for processing units 
with Files-1ll volumes mounted 


The line describing dynamic memory usage is in the form: 
totalmemory: freeblock:freebytes: fragments 


totalmemory 
Indicates the size of IOX dynamic memory in bytes. 


freeblock 
Indicates the size of the largest free block of IOX dynamic 
memory in bytes. 


bytes 
Indicates total free bytes available in IOX dynamic memory. 


fragments 
Indicates the number of memory fragments in IOX dynamic memory. 


E.7.2 Displaying Unit Status 
The SPY command displays the status of the unit or units you are 
exercising. The following line is an example of a SPY command display 
line: 

DBO: -- TYPE=F1l VBN=305. I/0=AST QUEUED FUNCTION=WRITE 
This line indicates: 


e The unit being exercised (DBO:) 


e The current virtual block being exercised (305(10)) 
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e The type of volume mounted on the unit (Files-11) 
e I/0 request status: AST QUEUED, IN PROGRESS, or IDLE 


e The type of I/O function being performed (write) 


E.7.3 Displaying the Units in Your Configuration 


The CONFIGURE command displays all devices that are part of your 
system's configuration. 


For example: 
IOX>CONFIGURE 
This command produces the following display: 


DBO DDO DFO DKO DLO DMO DPO DRO DSO Dx0 
DYO CTO DTO MFO MMO MSO MTO 


E.7.4 Displaying the Pattern Setting 


The PATTERN command displays all 11 possible patterns that IOX writes 
and reads during testing. 


For example: 
IOX> PATTERN 
This command produces the following display: 


000000,000000 
177777,177777 
125252,052525 
165555,133333* 
163126,163126 
055555,155555 
022222,122222 
111111,111111 
007417,007417 
021042,021042 
104210,104210 


FPOWUMANKHDUBWNHE 


Pe 


The asterisk indicates the default pattern that the system builds into 
IOxX, 


E.8 STARTING AND CONTROLLING IOX EXECUTION 


The START command begins execution of an I/0 exercise on units 
selected by the FILES11 command and the SELECT command. Section E.3.6 
describes how to use the START command. 


The CONTROL C command enables or disables the use of CTRL/C_ to 
interrupt an I/0 exercise (see Section E.4). CONTROL C YES enables 


interruptions to an I/O exercise; CONTROL _C NO disables interruptions 
to an I/O exercise. 
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E.8.1 Disabling Interruptions to an I/O Exercise 

When you set CONTROL _C NO the I/0 exercise cannot be interrupted. 
That is, when you enter CTRL/C, MCR prompts you and the rules for 
entering commands to MCR apply. The only way to terminate the I/0 
exercise in this case is to use the MCR ABORT command: 


>ABORT IOX 


E.8.2 Interrupting IOX to Enter Commands 

When you set CONTROL C YES, you can interrupt IOX to enter commands 
interactively by entering CTRL/C on your keyboard. For example, you 
can execute other tasks with the EXECUTE command or abort the I/0 
exercise with the IOX ABORT command. During this interactive session, 
however, IOX suspends display of error reports and activity reports to 
your terminal. 

PROCEED directs IOX to resume displays of error reports and activity 
reports at your’ terminal. When IOX is in interactive mode, these 


reports are discontinued even though the exercise continues’ to 
execute. 


E.8.3 Terminating an I/O Exercise and Restarting IOX 


The ABORT command terminates the execution of an I/O exercise and of a 
task or tasks initiated by the EXECUTE command. 


ABORT with no command qualifier terminates the execution of an I/0 
exercise before normal completion. 


ABORT with a task name terminates the execution of a task initiated by 
the EXECUTE command. For example: 


ABORT ...BAD 
This command aborts the Bad Block Locator Utility (BAD). 


ABORT /ALL terminates all the tasks initiated by the EXECUTE command 
and removes the tasks from the list of tasks to be executed by IOX. 


The RESTART command directs IOX to: 
@e Deselect and detach all units 
e Remove all user-configured units 
e Reset all parameters to default values 


e Return IOX to its original memory size 


E.9 USING INDIRECT COMMAND FILES WITH IOX 


You can use indirect command files with IOX in command mode. IOX 
accepts only one level of indirect command file; nested indirect 
files are not allowed. 
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You can use indirect command files to set up execution parameters for 
exercises. For example, the file RUN1O.IOX contains the following IOX 
commands to set execution parameters: 
LOGFILE YES 
RUNTIME 10 
SUMMARYTIME 1 
CONTROL C NO 
To execute this indirect command file, you enter the command: 
@RUN10.10X 


IOX accesses the file RUN10.IOX and executes the commands, setting the 
execution-time parameters. 


Comments are allowed on command lines. 


E.10 COMMAND DESCRIPTIONS 

This section provides complete descriptions of IOX commands and_ the 
rules for entering them on command lines. The commands are arranged 
in alphabetical order. 


Notational Conventions 


The paragraphs below describe the notational conventions used in this 
section to define IOX command elements and how to enter them on 
command lines. 

Command Line Elements 

IOX command lines consist of command lines and qualifiers. You can 
abbreviate both the command name and the qualifier using the rule 
described below under "Command Abbreviations," 

There are two types of command qualifiers: one type requires numeric 
settings and the other requires YES/NO settings. 

Default Values for Command Qualifiers 

Where there is a default value for a command qualifier, that value is 


stated explicitly in the command description. 


Use of Uppercase Characters 


Where uppercase characters appear in a command line format, the 
uppercase characters must be entered as they are shown. 


Use of Lowercase Characters 
Lowercase letters, words, or symbols in command line format 
specifications represent variables for which values' should be 


substituted. For example: 


dduu: 
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These letters represent the values that make up a device 
specification. Values can be substituted for each of these variables 
as appropriate. 
Use of Colons (:) 
Colons are used in device specifications as delimiters. In this case, 
the colon is required. Colons are also used to separate related parts 
of certain command line elements. For example: 

BADBLOCKS DK2: 70:3 
The colon following the device specification is the specification 
delimiter; the colon in 70:3 is the command element separator; it 
means enter a sequence of 3 bad blocks beginning at block 70. 
Command Abbreviations 
Where short forms of commands or qualifiers are allowed, the shortest 
form acceptable is represented by uppercase letters. The following 
example shows the abbreviations allowed for the I0OX LOGFILE YES 
command: 

LOgfile Yes 
This notation means that LO, LOG, LOGF, LOGFI, LOGFIL, and LOGFILE and 
Y, YE, and YES are valid specifications for the LOGFILE command. 


Use of Braces ([]) 


Braces are used to denote optional entries in a command line. 


Use of At Sign (@) 


The at sign (@) is used to invoke an indirect command file. The at 
sign precedes the file specification for an indirect command file: 


@filename.filetype;version 


All numeric values are entered in decimal, with the exception of 
device unit numbers and file version numbers. 
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ABORT 


Abort [taskname] 


{ /ALL ] 


The ABORT command terminates the execution of an I/O exercise and 
any tasks initiated by the EXECUTE command. 


ABORT with no command qualifier terminates the execution of an 
I/O exercise before normal completion. 


ABORT with a task name terminates the execution of a task 
initiated by the EXECUTE command. For example: 


ABORT ...BAD 
This command aborts the bad block locator utility. 
ABORT /ALL terminates the execution of all the tasks initiated by 


the EXECUTE command and removes the tasks from the list of tasks 
to be executed by IOX. 


iti 
t 
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BADBLOCKS 


BAdblocks ddnn: [blocknum:number,...[number,...J...] 


The BADBLOCKS command allows you to enter the block numbers of 
bad blocks on the unit I0OX is to test. In the format above, 
number specifies the number of sequential bad blocks beginning at 
the specified block number (blocknum in the format). The colon 
is required when you specify a sequence of bad blocks in this 
form. For example: 


BADBLOCKS DK2: 70:3 


This command enters the block numbers 70, 71, and 72 in the I0OX 
bad block list. 


You can also specify the address of a single bad _ block. For 
example: 


BADBLOCKS DK2: 3 
This command enters block 3 in the IOX bad block list. 


You can use both of these forms on the same command line, for 
example: 


BADBLOCKS DK2: 100:2,3,300:100 


This command enters blocks 100, 101, 3, and 300 through 399 in 
the IOX bad block list. 


When you enter only the device name, IOX displays the bad blocks 
in its bad block list. For example: 


BADBLOCKS DK2:; 
This command causes IOX to display: 


00070:003 
00100:002 
00003:001 
00300:100 


The first number in the display represents the beginning of the 
sequence of bad _ blocks; the second number in the display 
represents total bad blocks in a sequence of bad blocks. 


Bad block numbers entered with the IOX BADBLOCKS command are 
temporary and are used only by IOX in its testing. That is, I0OX 
ignores the bad blocks recorded by the manufacturer or _ such 
utilities as BAD; IOX uses only the blocks you enter with the 
BADBLOCKS command. 
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BUFFERSIZE 


BU£Efersize bytes 
The BUFFERSIZE command changes the size of the buffer IOX uses 
when exercising units with non-file-structured volumes. I0OX 
stores the specified buffer size in byte form (rounded up to. the 
next 4-byte boundary) and I0X requests buffers of that size 
dynamically, as necessary. 


This command is not valid if units are currently selected. 


CONFIGURE 


CONFigure [dduu:] 
The CONFIGURE command enters a unit in the test configuration. 
(Units must be configured before they can be selected for testing 
by the SELECT or FILES11 commands.) The CONFIGURE command also 
displays the units in the test configuration. 


CONFIGURE with a qualifier adds a unit to the test configuration. 
For example: 


CONFIGURE DK20: 
This command adds device DK20: to the test configuration. 


CONFIGURE with no qualifiers lists all the devices in the test 
configuration: : 


IOX>CONFIGURE 


DBO: DBl: DB2: DDO: DFO: DKO: DK20: DLO: DMO: DPO: 
DRO: DSO: DxXO: DyYO: CTO: DTO: MFO: MMO: MSO: MTO: 


Unit 0 is configured by default. 
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CONTROL_C 


CONTrol C [Yes] 
[No ] 


The CONTROL _C command enables or disables the use of CTRL/C_ to 
interrupt an I/O exercise. 


CONTROL C YES enables interruptions to an I/O exercise; 
CONTROL _C NO disables interruptions to an I/O exercise. 


When you set CONTROL _C YES you can interrupt an I/O exercise to 
enter IOX commands interactively. For example, you can execute 
other tasks by means of the EXECUTE command or abort the 1/0 
exercise by means of the IOX ABORT command. 


When you interrupt an exercise with CTRL/C, the exercise 
continues to execute, but error reports and activity reports are 
not displayed at your terminal. Further, CTRL/C causes the I0OX 
clock to stop at the next summary interval, even though the 
exercise continues to execute. Therefore, the execution times 
shown in activity reports may not show how long the I/O exercise 
actually executes. 


When you set CONTROL_C NO, the I/0 exercise cannot be 
interrupted. When you enter CTRL/C, MCR prompts you and the 
rules for entering commands to MCR apply. The only way to 


terminate the I/0 exercise in this case is to use the MCR ABORT 
command: 


MCR>ABORT IOX 
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DENSITY 


DENSity dduu: [nnnn] 


The DENSITY command sets the tape density and characteristics 
word for IOX to use while testing magnetic tape units. 


Three densities are legal for MT: devices: 
200, 556, and 800 BPI 

Two densities are legal for MM: devices: 
800 and 1600 BPI 

One density is legal for MS: devices: 


1600 BPI 


The device must be specified when setting the density. For 


example: 
IOX>DENS MT: 556 
This command sets the tape density for MT: testing to 556 BPI. 


If you do not specify the density, [nnnn], but specify the device 
unit, as follows 


IOX>DENS MM: 


IOX displays the current tape density setting and characteristics 
word for MM: devices. For example: 


DENSITY = 800 BPI CHARACTERISTICS WORD = 04004 (OCTAL) 
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DESELECT 


DESelect dduus: 


The DESELECT command terminates testing on the specified device. 
DESELECT terminates I/O operations to the specified unit, deletes 
the bad block list associated with the unit, deassigns the LUN 
for the unit, and detaches the unit from the test configuration. 


The unit remains in the configuration. 


ERRORLIMIT 


ERrorlimit number 


The ERRORLIMIT command sets the number of errors’ tolerated 
between interval reports before IOX deselects a device because of 
too many errors. For example: 


SUMMARYTIME 2 
ERRORLIMIT 10 


If you request summary reports every two minutes and an error 


limit of 10 errors, IOX allows up to 10 errors on a unit in that 
2-minute interval before deselecting the unit. 


EXECUTE 


EXEcute taskname commandstring 


EXIt 


The EXECUTE command directs a command line to RSX-11M_ for 
execution. You can enter the EXECUTE command while IOX is in 
command mode or when IOX is in interactive mode. In both cases, 
output directed to your terminal from the spawned task is 
displayed at your terminal whether or not an exercise is 
executing. 


All the rules for entering RSX-11M command lines and the use of 
the SPWNS directive apply to the parameters you enter on the 
EXECUTE command line. 


A practical example of the use of EXECUTE is to run the _ BAD 
utility to list the bad blocks on a volume at your terminal: 


EXE ...BAD DKO:/LI 


This command line invokes the BAD utility, which then lists any 
bad blocks on a volume at your terminal. 


EXIT 


The EXIT command terminates IOX processing and exits from IOX to 
the operating system monitor. 
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FILES11 


Filesll dduu: filesize 


The FILES11 command selects a unit with a Files-l1l volume for an 
I/O exercise. The unit must first be entered in the test 
configuration with the CONFIGURE command. 


The FILES11 command performs the same function as the SELECT 
command. FILES11 is used to select units with Files-1l11 volumes; 
SELECT is used to select units with non-file-structured volumes. 


An example of the FILES11 command is: 

FILES11 DKl: 1000 
This command selects the unit DKl1: for I/O exercising. The 
number 1000 overrides the file size of the temporary file IOX 
uses to process units with Files-11 volumes mounted. 
IOX uses a temporary file when it processes units with Files-1l 


volumes. ~ You can set the size of this file with the 
TEMPORARYFILE command. 


HELP 


Help 


The HELP command displays a summary description of IOX commands 


-at your terminal. 


INTERLEAVE 


INterleave number 


The INTERLEAVE command specifies the interleave factor (in number 
of blocks) for exercising units. 


When IOX writes the test pattern to disk, it can write the 
pattern to either random blocks or to a specified sequence of 
blocks. You can direct IOX to write to random blocks by entering 
the RANDOM command: 


RANDOM YES 
When you direct IOX to write to a sequence of blocks (RANDOM NO 
is set), use INTERLEAVE to specify the number of blocks to be 
skipped before the next pattern is written. For example: 


RANDOM NO 
INTERLEAVE 2 


In this example, the interleave factor is set to two and IOX 
writes to and reads from every second block on the disk (block 0, 
block 2, block 4, and so forth) beginning at block 0. For 
DECtapes, the only interleave factor allowed is 4. 
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ITERATIONS 


ITerations number 


The ITERATIONS command specifies the number of times IOX executes 
its idle loop before it counts an iteration through the idle 
loop. For example: 


ITERATIONS 10 


IOX counts one iteration for every 10 times it executes its idle 
loop. 


The ITERATIONS command is used with the WAIT command to measure 
system activity. 


LOGFILE 


Logfile [Yes] 
{ No] 


The LOGFILE command enables you to direct activity reports and 
error reports to either your terminal or to a log file called 
SY0:IOX.LOG. LOGFILE YES directs reports to the log file; 
LOGFILE NO directs reports to your terminal. LOGFILE NO is the 
default. 


Other types of output (from the PRINTSUMMARY command or SPY 
command, for example) are always directed to your terminal. 


IOX notes the time you started the log file and the time you 
completed entering data to it in the activity reports. Once 
IOX.LOG is created, IOX appends data to the end of the file 
without creating new versions of the file. 


Refer to Section E.6, "I/O Exercise Output," for more information 
on how to use the LOGFILE command. 
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PARAMETERLIST 


PARameterlist 


The PARAMETERLIST command displays the settings of the I0X 
execution parameters at the time you entered the command. It 
also, displays information on currently selected devices, active 
tasks, and the amount of dynamic memory in use. 


When you enter the PARAMETERLIST command, IOxX displays 
information in the following form: 


IOX>PARAMETERLIST 

TASK STATUS COMMAND LINE 

eeeBAD QUEUED DKO:/LI 

DEVICE LUN BUFSIZE TYPE FILESIZE 
DB1: 5. Di2s Fll 500. 
DB2: 6. 512. Fll 500. 
MM1: 7. 1024. NFS 

BUFFERSIZE= 1024. CONTROL _C= YES 

ERRORLIMIT= 10. LOGFILE= NO 

INTERLEAVE= 4. RANDOM= YES 

ITERATIONS= 10. REPORTERRORS= YES 

PATTERN= 4. RETRIES= NO 

RUNTIME= 5. VOLUMECHECK= YES 

SUMMARYTIME= 1. WAIT= YES 

TEMPORARYFILE= 500. WRITECHECK= NO 


DYNAMIC MEMORY USAGE= 3278.:2248.:2248.:1. 


For tasks initiated by the EXECUTE command, the 
PARAMETERLIST command displays: 


e The installed task name (...BAD) 


e The execution status (QUEUED, ACTIVE, SUCCESS, WARNING, 
ERROR, SV ERROR) 


e The command line elements you entered (DK0:/LI) 


ACTIVE indicates that IOX is being executed. The remaining 
status indications relate to Exit with Status (EXST$) Executive 
directive. For more information on these status indications, 


refer to the RSX-11M/M-PLUS Executive Reference Manual. 


For selected units, PARAMETERLIST displays the following 
information: 


e Device specifications (DBl:, DB2:, and MM1:) 

e Logical Unit Number (LUN) (5, 6, and 7) 

e Buffer size IOX uses for reads and writes (512(10) for 
units with Files-1l1l volumes mounted; 1024(10) for units 
with non-file-structured volumes) 

e Type of volume mounted on unit (Fll for Files-1l; NFS 


for non-file-structured volumes; VFY for units being 
verified) 
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e File size of the temporary file IOX uses for processing 
units with Files-1l1 volumes mounted 
wd The line describing dynamic memory usage is in the form: 
totalmemory: freeblock: freebytes: fragments 


totalmemory 
: Indicates the size of IOX dynamic memory in bytes. 


freeblock, 
Indicates the size of the largest free block of IOX dynamic 


memory in bytes. 


bytes 
Indicates total free bytes available in IOX dynamic memory. 


fragments 
Indicates the number of memory fragments in IOX dynamic memory. 
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PATTERN 


PATtern [patternnumber] 


The PATTERN command sets the pattern IOX writes and reads during 


testing. There are 11 patterns, each specified by one of the 
following numbers: 


Pattern 
Number Pattern 


000000,000000 
177777 ,177777 
125252,052525 
165555,133333 * 
163126 ,163126 
055555,155555 
022222,122222 
111111,111111 
007417,007417 
021042,021042 
104210,104210 


FOU ONAU PWD EF 


a 


For example: 
PATTERN 3 


This command directs IOX to use the pattern 125252,052525 when it 
writes to units for testing. IOX places an asterisk (*) next to 
the selected pattern when you display the patterns. 


Pattern 4 is the default pattern. 


PRINTSUMMARY 


PRIntsummary 


The PRINTSUMMARY command prints the totals for I/0 exercise 
activity between the time of the last interval Summary report and 
the time you entered the PRINTSUMMARY command. These totals are 
printed in the form of a summary report displayed at your 
terminal. Section E.6, "I/O Exercise Output," shows the form of 
a print summary report. 


PROCEED 


PROceed 


The PROCEED command is used to resume display of I0X activity 
reports and error reports at your terminal and to restart the IOxX 
clock after these functions have been suspended by CTRL/C. 


CTRL/C suspends activity and error reporting and stops the I0OX 


clock. PROCEED resumes reporting to your terminal and restarts 
the IOX clock. 


i 
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RANDOM 


RAndom [Yes] 
[No ] 


The RANDOM command directs IOX to use a random number’ generator 
to choose the blocks on the disk being exercised. RANDOM YES 
directs IOX to use the random number’ generator; RANDOM NO 
directs I0OX to use the number of sequential blocks specified in 
the INTERLEAVE command. 


Refer to the command description of the INTERLEAVE command _ for 
information on how to use INTERLEAVE. 


REPORTERRORS 


REPorterrors [Yes] 
[No ] 


The REPORTERRORS command enables or disables IOX error’ reports. 
REPORTERRORS YES directs IOX to report errors; REPORTERRORS NO 
disables error reports. REPORTERRORS YES is the default. 


When you direct IOX to report errors, IOX directs the error 
reports either to your terminal or to the log file IOX.LOG, 
depending on how you have set the LOGFILE command. (See the 
command description of LOGFILE for information on how to use 
LOGFILE.) : 


IOX error reports have the following form: 


DK1: -- UNRECOVERABLE ERROR AT BLOCK 358 (DECIMAL) (OCTAL) 
DK1: -- DATA ERROR AT BLOCK 358 (DECIMAL) (OCTAL) 
GOOD DATA: 165555 BAD DATA: 167155 (OCTAL) 
WORD POSITION: 308 (DECIMAL) 464 (OCTAL) 


RESTART 


REStart 


The RESTART command directs IOX to deselect and detach all units, 
remove all user-configured units, reset all parameters to their 
default values, and return the exerciser task to its original 
memory size. 


RETRIES 


RETries [Yes] 
[No ] 


The RETRIES command directs an I/O driver to either retry or not 
retry an I/O operation after it receives an error on the first 
attempt at the operation. RETRIES is used when exercising units 
with non-file-structured volumes. 
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RUNTIME 


RUntime minutes 


The RUNTIME command specifies the amount of time in minutes’ that 
Iox is to test a unit or units. For example: 


RUNTIME 2 


This command directs IOX to exercise selected devices for two 
minutes. If you specify RUNTIME 0, IOX tests units continuously. 


The default run time is five minutes. 


SELECT 


SElect dduus {[(buffsize] 


The SELECT command selects a unit with a non-file-structured 
volume for an I/O exercise. An example of the SELECT command is: 


SELECT DK1l: 2000. 


This command selects unit DK1l: for an I/O exercise and specifies 
a buffer size of 2000(10) bytes for IOX processing. 


The unit must be configured with the CONFIGURE command before you 
can select it. 


The SELECT command allows an I/O exercise to destroy all the data 
structures on the mounted volume. To ensure that the mounted 
volume is not a Files-1ll volume, enter: 

VOLUMECHECK YES 


If you do not specify the buffsize parameter, the size specified 
in the last BUFFERSIZE command applies. 


The default buffer size is 1024 bytes. 
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SPY 


SPy [dduu:] 
The SPY command displays information describing the current 
Status of a unit or units. When you specify no device on the 
command line, the status of all units is displayed. 


SPY displays status information in the following form: 


DBO: -~ TYPE=Fll VBN=305. I/0O=AST QUEUED FUNCTION=WRITE 
This line indicates: 
e The unit being exercised (DBO:) 
e The type of volume mounted on the unit (Files-11) 
@ The Virtual Block Number being tested 305(10). (This 
would be the Logical Block Number (LBN) for an 
unformatted volume) 


e I/0 request status: AST QUEUED, IN PROGRESS, or IDLE 


e The type of I/O function being performed (WRITE) 


START 


Start 
The START command starts execution of an I/O exercise on units 
selected by the FILES11 command and the SELECT command. Refer to 
Section E.3, "Installing, Invoking, and Running IOX in an 


Exercise Example," for information on how to use the START 
command. 


SUMMARYTIME 


SUmmarytime [minutes] 


The SUMMARYTIME command specifies the time interval in minutes 
between interval summary reports. For example: 


SUMMARYTIME 15 


This command specifies that you want a summary report generated 
every 15 minutes. 


A value of 0 specifies that you want no summary reports. 


The default for the interval between summary reports is 1 minute. 
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TEMPORARYFILE 


TEmporaryfile [filesize] 


The TEMPORARYFILE command is used when you want to exercise a 

unit with a Files-11 volume mounted. TEMPORARYFILE specifies the 

size in blocks of the temporary file IOX uses when it tests 4 
file-structured devices. This file is marked for deletion when 

IOX exits. Thus, if IOX terminates prematurely, your file 

structure is not corrupted with temporary files used by IOX. 


VERIFY 


VErify dduu: [blocks] 


The VERIFY command is used with units that have 
non-file-structured volumes mounted. VERIFY ensures that a y~ 
device is performing I/O correctly by reading the number of Siia ae 
blocks (specified by the blocks parameter) from the specified 

unit. 


IOX performs no pattern checking with VERIFY; that is, no I/0 
exercise is performed. 


VOLUMECHECK 


am, 
vOlumecheck [Yes] 
[No ] 
The VOLUMECHECK command enables or disables a check by I0X to 
determine whether or not a unit being tested as 
non-file-structured has a home block. If you check for the home 
block and I0xX finds a home block on the unit, IOX issues a 
message warning you that the unit has a Files-11 volume mounted 
and you may be destroying vital information. 
The default is VOLUMECHECK YES. si 
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WAIT 


WAit [Yes] 
[No ] 
The WAIT command is used with the ITERATIONS command to measure 
system activity. IOX executes an idle loop while it waits for 
you to enter a command. It can execute either one of the 


following in this loop: 
l. The wait-for-event-flag algorithm 
2. The instruction 
BICB -(SP),(SP)+ 


The BICB instruction takes up a large amount of CPU time and can 
be used to measure I/O throughput. 


The wait-for-event-flag algorithm is the default, but you can 
disable it and execute the BICB instruction by entering the 
command 


WAIT NO 


Refer to Section E.5.4, "Setting Execution Conditions for 
Measuring System Activity," for information on how to use the 
WAIT command, 


WRITECHECK 


WRitecheck [Yes] 
[NO ] 


THE WRITECHECK command enables or disables write checks by I/0 
drivers when they perform I/O during an I/O exercise. WRITECHECK 
is used to exercise units with non-file-structured volumes. 
WRITECHECK YES directs the I/0 driver to perform write checks; 
WRITECHECK NO directs the I/O driver to disable write checks. 


When an I/O driver performs an I/O operation, it issues’ three 
instructions: WRITE, WRITE CHECK, and READ. By eliminating one 
of these I/O operations, you can increase the speed of the I/0 
exercise. 


The default is WRITECHECK NO. 
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E.11 IOX MESSAGES 

IOX displays the following messages. When it can determine that a 
specific device unit is involved, IOX also displays the device unit. 
dduus: -- BAD BLOCK, XXX (DECIMAL) XXX (OCTAL) 


Explanation: The error code returned to IOX was IE.BBE (bad block 
error). 


User Actions: Use the BADBLOCKS command to enter that bad _ block 
into the IOX bad block list. 


dduu: -- DATA ERROR AT BLOCK XXX (DECIMAL) XXX (OCTAL) 
GOOD DATA: XXXXXX BAD DATA: XXXXXX (OCTAL) 
WORD POSITION: XXX (DECIMAL) XXX (OCTAL) 
Explanation: IOX found an error when comparing the read data with 
the written data. The position of the word within the IOX data 
buffer is shown along with the good and bad data. 
User Action: None. If the error persists, enter that block in 
the bad block list by using the BADBLOCKS command (for 
non-file-structured devices only.) 
dduu:s -- DATA OVERRUN AT BLOCK XXX (DECIMAL) XXX (OCTAL) 
Explanation: IOX received an error return of IE.DAO. The record 
size given was greater than that read. This error occurs on tape 
devices only. 


User Action: None. 


dduu: -- END OF VOLUME SEEN 


Explanation: IOX attempted to write a record past the end of tape 
marker. 


User Action: None. 


dduu: -- ERROR THRESHOLD EXCEEDED 


Explanations: The number of errors set with the ERRORLIMIT command 
has been exceeded. 


User Action: None. This is an information message only. IOX 
deselects the unit and continues testing the other devices. 


dduu: -- FAILED TO DETACH UNIT 


Explanation: This error is extremely rare because IO0OX detaches 
all units that it has attached and only those units. 


User Action: None. This is a possible operating system problem. 
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dduu: -- FATAL HARDWARE ERROR 


Explanation: The IE.FHE (fatal hardware error) I/O error code was 
returned to IOX. IOX could not recover from the error. 


User Action: Check the hardware. 


dduu: -- I/0 REQUEST ABORTED 


Explanation: The IE.ABO I/O error code was returned to IOX. The 
QIO to the device failed. 


User Action: None. If the problem persists, check the system 
code (Executive or driver). 

dduu: -- I/0 UNSATISFIED AT TIMEOUT - FUNCTION: XXXX 
Explanation: When IOX finishes processing, it waits five seconds 
for I/0 to stop. If a long tape is rewinding, this message may 
occur. XXXX is the function that timed out: READ, WRITE, or 
REWIND. 


User Action: None. 


dduu: -- NO RESPONSE 
Explanation: Unit did not respond to IOX command within = one 
minute. The device may have been accidentally put offline or a 
tape drive may have lost its column vacuum. 


User Action: Check the device. 


dduu: -- NOT READY 
Explanation: The unit is not ready. 


User Actions: Check the device. 


dduu: -- OFF-LINE 
Explanation: The unit is offline. 


User Action: Check the unit. 


dduus: -- PRIVILEGE VIOLATION 


Explanation: The device was not allocated or was mounted by 
someone else, 


User Action: Check the ownership of the device. 
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dduu: -- UNIT CONTAINS FILE STRUCTURED VOLUME 


Explanation: The VOLUMECHECK command found that the unit is 


file 


structured because the file contains a home block. You are not 


allowed to use the SELECT command on this unit. 


User Action: IOX destroys information on non-file-structured 


volumes. Make certain that you really want this unit tested 
non-file-structured volume. 

dduu: -- UNIT NOT MOUNTED FOR NFS OPERATIONS 
Explanation: You tried to issue a command for 
non-file-structured device to a file-structured device. 
User Actions Check the device configuration and reissue 
command. 

dduu: -- UNEXPECTED ERROR XX 
Explanation: IOX received an error code that it could 
process. XX is the error code. 
User Action: None. 

dduu: -- UNEXPECTED REQUEST TO QUEUE I/O - REQUEST ABORTED 
Explanation: IOX receives an AST from a device after it 
deselected the device. 
User Action: Check the device. 

dduu: -- UNRECOVERABLE ERROR AT BLOCK XXX (DECIMAL) XXX (OCTAL) 
Explanation: IOX received an IE.VER code from the driver. 
code indicates an unrecoverable error. 
User Action: Check the device and the media. 

dduu: -- VERIFICATION COMPLETE 
Explanation: This is an information message. The operation 


the VERIFY command has completed. 


User Actions: None. 


dduu: -- WRITE-LOCKED 
Explanation: The device is write-locked. 


User Action: Check the device write-lock/write-enable switch. 


dduus -- WRITECHECK ERROR AT BLOCK XXX (DECIMAL) XXX (OCTAL) 
Explanation: The write check operation failed at block XXX. 


User Action: None. 


as a 
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has 


This 


of 


THE RSX-11M I/O EXERCISER 


IOX -- "@" SYNTAX ERROR 
Explanation: There is an error in the indirect command file. 


User Actions: Check the indirect command file. 


IOX -- "@" NESTING LEVEL EXCEEDED 


Explanation: Only one level of nesting is allowed in an indirect 
command file. 


User Action: Check that the indirect command file has only one 
level of nesting. 
IOX -- ABORTING DUE TO MCR/PDS COMMAND OR DIRECTIVE 


Explanation: IOX was aborted from an external source, but did the 
necessary housekeeping before exiting. 


User Action: Restart IOX. 


IOX -- BUFFER SIZE GREATER THAN DEFAULT 


Explanation: The buffer size used in the SELECT command is 
greater than the default buffer size in the BUFFERSIZE command. 


User Action: Respecify the SELECT command. 


IOX -- COMMAND NOT SUPPORTED 
Explanation: This error indicates an attempted execution of the 
EXECUTE command on a system that did not have the SPAWN directive 
in the Executive. 
User Action: You may have to do another system generation to get 
the SPAWN directive into your Executive. 


IOX -- COMMAND I/O ERROR 


Explanation: IOX detected an error when it tried to read the 
command that you were typing in at the terminal. 


User Actions: Retype the command. 


IOX -- COMMAND VALID ONLY AFTER ABORT 
Explanation: You tried to enter a command that cannot be entered 
while IOX is running. These commands are: RUNTIME, BUFFERSIZE, 
PATTERN, RESTART, and START. 


User Action: Enter these commands in command mode. 
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IOX -- COMMAND NOT UNIQUE 


Explanation: The command abbreviation that you entered was not am 
sufficient to distinguish it from another command. 


User Action: Reenter the command with more letters. 


IOX -- DRIVER NOT LOADED 
Explanation: IOX tried to attach a device which had an _ unloaded 
driver. 
User Action: Load the driver. id 
IOX -- DUPLICATE BLOCK NUMBER 


Explanations: The block number that you entered with the BADBLOCKS 
command is already in the bad blocks list. 


User Action: Reenter the command. i, 


IOX -- ERROR ATTEMPTING TO READ HOME BLOCK 


Explanation: When the VOLUMECHECK command has been given, this 
error occurs if IOX reads a home block or has an error trying to 
read a home block. The error indicates that IOX has found a 
file-structured volume and may destroy the information on it. 


User Action: Stop IOX and check the disk that you have mounted on 
that device unit. 


IOX -~- FAILED TO OPEN TEMPORARY FILE ON dduu: 
Explanation: IOX could not find the necessary number of blocks on 
the disk as specified in the FILES11 command or the TEMPORARYFILE 
command. 


User Action: Specify a smaller file size. 


IOX -- FAILED TO OPEN "@" FILE 
Explanations GCML failed to open the indirect command file. 


User Actions: Make sure that the file exists and reenter’ the 
indirect command file. 


IOX -- FAILED TO OPEN LOG FILE < 
Explanation: IOX could not open the log file. 


User Action: The disk may be write protected or may not have 
enough blocks. 
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IOX -- FAILED TO CLOSE LOG FILE 


IOXx 


IOx 


IOX 


IOxX 


IOX 


IOX 


Explanation: IOX could not close the log file. 


User Action: Check the device. 


-- FAILED TO ATTACH dduu: 
Explanation: IOX could not attach unit. 
User Action: The device may be mounted or someone else attached 
the unit. Make sure that you have allocated the device and that 
it is mounted foreign for RSX-11M-PLUS. For RSX-11M it does not 
have to be mounted. 

-- FATAL FILES ERROR. F.ERR= XXX PC+2= XXX 
Explanation: An error occurred while IOX was trying to issue a 
READS or a WRITES command. F.ERR is the error code in the FDB. 


PC+2 is the location of the error in IOX. IOX immediately exits. 


User Action: Investigate the source of the error in the code. 


~- FATAL ERROR. DSW= XXX PC+2= XXX 
Explanation: A directive issued by IOX did not work. DSW is_- the 
directive status word. PC+2 is the location of the failure in 
IOX. IOX immediately exits. 


User Action: Investigate the source of the error in the code. 


-- FILES OPERATIONS NOT SUPPORTED ON dduu: 


Explanations: You entered a FILES11 command to a volume that is 
not a Files-1l1l volume. 


User Action: Reenter the command for the correct device or use a 
different command. 
-~ ILLEGAL DENSITY 


Explanation: The density that you specified for the device is 
incorrect. The device does not support that density. 


User Action: Reenter the command using a different density or 
device. 

-- ILLEGAL UNIT SPECIFICATION 
Explanation: The syntax of the unit specification is incorrect. 


User Action: Reenter the command. 
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IOX -- INVALID BLOCK NUMBER : 


Explanation: The block number that you entered for the BADBLOCKS ~ 
command was not a valid block number for that device. 


User Action: Reenter the command using a different block number. 


IOX -- INVALID TASK NAME - 
Explanation: The task name that you entered is invalid. That is, 
the task name is incorrect, the task does not exist, or the task 
is not installed. . 


User Action: Reenter the task name or determine whether the’ task 
exists or is installed. 


IOX -- INVALID PATTERN NUMBER 


Explanations You tried to set a data pattern for IOX to use _ for 
I/O testing that IOX did not recognize. 


User Action: Check the PATTERN command and reenter the correct 
data pattern. 

IOX -- INVALID COMMAND - TYPE H FOR HELP 
Explanation: You entered a command that IOX did not recognize. 


User Action: Enter H (for help) and IOX displays all of its 
commands. 


IOX -- NO BUFFER SPACE 


Explanation: IOX could not extend to make room for a _ needed 
larger buffer. 


User Action: Reinstall IOX with a larger increment. 


IOX -- NO LUNS AVAILABLE 4am, 


Explanation: This is an unlikely message because IOX allows 250 
devices. Unless you have more than 250 devices, this message may 
indicate a system problem. 


User Action: If you have less than 250 devices, call your 
software specialist. 


b 


IOX -- NO ACTIVITY REMAINS - ABORTING 


Explanation: All disk testing and all tasks are finished before 
the run time has expired. : 


User Action: None. 


THE RSX-11M I/0 EXERCISER 


IOX -- NO ACTIVITY TO START 


IOX 


IOx 


ITOX 


IOX 


TOX 


Explanation: You issued the START command without defining the 
configuration or units to exercise. 


User Action: Configure and define the devices that you want to 
exercise. 


-- ONLY “C ALLOWED 
Explanation: You previously entered the CONTROL_C YES command to 
enable interruptions to IOX. Therefore, IOX does not accept any 
other input but CTRL/C. 


User Action: Enter CTRL/C then enter the command. 


-~ SYNTAX ERROR 


Explanation: The command line that you entered contained a syntax 
error. 


User Action: Reenter the command line. 


-~ TASK NEVER EXECUTED 


Explanation: The task that you tried to abort is not on the list 
of tasks initiated by the EXECUTE command. 


User Action: Check your list of tasks to be initiated by the 
EXECUTE command. 
-- TASK "XXXXXX" CURRENTLY ACTIVE 


Explanation: You tried to execute a task that was already active. 
XXXXXX is the task name. 


User Action: None. 


-- TASK "XXXXXX" EXECUTION COMPLETE. STATUS= NNNNNN 


Explanation: The task completed execution. XXXXXX is the task 
name. NNNNNN is the task status, 


User Action: None. 


IOX 


IOX 


IOX 


IOX 


IOX 


THE RSX-11M I/O EXERCISER 


-- TASK "XXXXXX" NOT INSTALLED 


Explanation: The task name "XXXXXX" is not installed and cannot 
be executed as requested. 


User Action: Install the task. 


-- TASK "XXXXXX" UNABLE TO EXECUTE 


Explanation: IOX could not execute the task within a specified 
time. 


User Action: Try to reexecute the task. 


-- UNABLE TO ASSIGN LUN TO dduu: 


Explanation: You tried to access a unit that is not on _ the 
system. 


User Action: Check the system configuration, 


-- UNIT NOT A MAGTAPE 


Explanation: You tried to issue a DENSITY command to a device 
that is not a magnetic tape device. 


User Actions Reissue the command. 


-- UNIT NOT SELECTED 


Explanation: You issued a device-dependent command to a device 
that you have not selected with the SELECT command or the FILES11 
command. 


User Action: Determine which device you want to affect and select 
it with the SELECT or FILES-11 command. 


IOX - UNIT IS FILE STRUCTURED 


Explanation: You used the BADBLOCKS command to try to create a 
bad blocks list on a file-structured volume. The command did not 
execute, 


User Action: Make certain that you really want IOX to write on 
this device. 


IOX -- UNIT ALREADY CONFIGURED 


Explanation: You tried to configure a unit with the CONFIGURE 
command that is already in the configuration. 


User Action: Check the IOX device configuration. 


a 
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IOX -- UNIT NOT CONFIGURED 


Explanation: You tried to access a unit that is not in the I0OX 
unit configuration. 


User Action: Configure the unit using the CONFIGURE command. 


IOX -- UNIT ALREADY SELECTED 


Explanation: You tried to select a unit that has already been 
selected. 


User Action: Check the printout to find which units you have 
previously selected. 


IOX -- UNITS ARE SELECTED - COMMAND IGNORED 


Explanation: The BUFFERSIZE command is valid only if no units are 
selected by either the FILES11 or SELECT command. 


User Actions Deselect all selected units. 


E.11.1 I0OX Task Builder Command File 


IOX is built with the defaults that it needs to perform its required 
functions. The Overlay Description Language (ODL) file for IOX 
resides on UIC [1,20] on the system disk. If you want to rebuild I0OX 
with different defaults, you can create a Task Builder command file 
like the one the system uses, which is shown below, and put it on UIC 
[1,24] for a mapped system or UIC [1.20] for an unmapped system. 
These UICs are RSX-11M-PLUS/RSX-11M system conventions. 


The system command file for building IOX puts the IOX task on system 
UIC [1,54] for a mapped system; the UIC for system tasks on an 
unmapped system is [1,50]. The command file is shown as inline code 
with commentary. 


(The RSX-11M Task Builder and the ODL are described in the 
RSX-11M/M-PLUS Task Builder Manual.) 


; BUILD MAPPED I/O EXERCISER V14 

a 

[1,54] IOX/FU/CP/MM, [1,34] IOX/-SP/CR/MA/-SH=[1,20] IOXBLD/MP 
STACK=96 

ASG=TI:1:2:4:5:6,SY0:3 

PRI=50 

TASK=...10X 

PAR=GEN 


NOW DEFINE THE MAXIMUM AMOUNT OF UNITS YOU WILL EVER WANT TO 
TEST. THE MAXIMUM IS 250 AND THE DEFAULT IS 32. 


Gus se te te 


NITS=32 
INHIBIT USER OF UNUSED FCS READ/WRITE LONG CODE. 


BLDEF=..RWLG: 0 


me G) we we Me 


THE RSX-11M I/O EXERCISER 


THE DEFAULT TEMPORARY FILE STRUCTURED BLOCK SIZE IS 
DEFINED HERE. THE NORMAL DEFAULT IS 500 DECIMAL (764 OCTAL) 


; 
GBLDEF=F11S1Z:764 


NOW WE WILL DEFINE THE DEFAULT 2-WORD PATTERN WHICH WILL BE 
USED TO FILL THE WRITE BUFFER. THE VALUE MUST BE BETWEEN 1 AND 13. 
THE VALUES CORRESPOND TO THE FOLLOWING PATTERNS: 
1 -- 000000,000000 
2 -- 177777,177777 
3 -- 125252,052525 
4 -- 165555.133333 
5 -- 163126,163126 
6 -- 055555,155555 
7 -- 022222,122222 
10 -= 111111,111111 
11 -- 007417,007417 
12 -- 021042,021042 
13 -- 104210,104210 


° 
tf 
e 
‘ 
° 
’ 
° 
7 
° 
¢ 
e 
c 
e 
a 
e 
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e 
a 
e 
‘ 
e 
c 
° 
‘ 
a 
e 
¢ 
e 
a 
° 
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BLDEF=PATERN: 4 

NOW WE WILL DEFINE THE CHARACTERISTICS USED FOR MAGTAPE TESTING. 
THE DEFAULT FOR TU10O IS CORE DUMP MODE; FOR ALL OTHERS IT IS 
1600 BPI MODE. SEE THE I/O DRIVERS REFERENCE MANUAL FOR FURTHER 
INFORMATION CONCERNING THIS VALUE. 
BLDEF=MAGSTC:004004 

NOW DEFINE THE DEFAULT TEST RUNTIME. 
BLDEF=RUNTIM: 5 

NOW DEFINE THE DEFAULT INTERVAL BETWEEN SUMMARY REPORTS. 
BLDEF=SUMARY:1 


NOW DEFINE THE ERROR THRESHOLD. THIS IS THE NUMBER OF ERRORS 
PERMITTED BETWEEN SUMMARY REPORTS BEFORE THE UNIT WILL BE DE-SELECTED. 


BLDEF=ERRMAX :12 


NOW DEFINE THE NUMBER OF ITERATIONS THAT WILL BE MADE IN THE 
BACKGROUND LOOP BEFORE A ITERATION IS COUNTED. 


BLDEF=ITRCNT:12 


NOW DEFINE THE INTERLEAVE FACTOR THAT IS USED FOR SEQUENTIAL 
NON-FILE STRUCTURED DISK OPERATIONS. 


BLDEF=INTRLV: 4 


NOW DEFINE THE DEFAULT NAME FOR THE EXERCISER. THIS NAME IS IN 
RAD50 AND IS USUALLY "IOX". 


BLDEF=IOXNAM: 035260 


NOW DEFINE THE DEFAULT NON-FILE STRUCTURED BYTE COUNT. THIS IS USED 
FOR ALL NON-FILE STRUCTURED DEVICES EXCEPT DECTAPE. THE USUAL VALUE 
IS 2 BLOCKS (2000(8) BYTES). 
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BLDEF=PABCNT: 2000 


’ 


; NOW WE WILL DEFINE THE UNSOLICITED AST CHARACTER. THIS IS THE 


BLDEF=SCC: 3 


@ Se we we G) te we MO 


GBLDEF=REPORT:1 
¢BLDEF=RANDOM:1 
GBLDEF=CONTIN:0 
GBLDEF=CTRLC:1 
GBLDEF=WAITF:1 


a 
GBLDEF=VOLCHK : 1 


V7 


THE RSX-11M I/O EXERCISER 


CHARACTER WHICH WILL INTERRUPT THE EXERCISER WHEN THE ‘CONTROL _C' 
FEATURE IS ENABLED. THE DEFAULT CHARACTER IS CONTROL/C. 


NOW WE WILL DEFINE SOME DEFAULT YES/NO VALUES. 
A VALUE OF "0" SIGNIFIES "NO"; A VALUE OF "1" SIGNIFIES "YES". 


+REPORT ERRORS TO CONSOLE 

;USE RANDOM DISK SEEKS 

7DO NOT RUN CONTINUOUS 

;USE UNSOLICITED AST'S 

;"WAIT" INSTRUCTION IN BACKGROUND LOOP 


;FILE STRUCTURED VOLUME CHECKING 


APPENDIX F 


SYSTEM CONVENTIONS 


F.1 RSX-11M UIC CONVENTIONS 


The RSX-11M Release 3.2 distribution kits observe a set of UIC 
conventions for files on disk. The purpose of these conventions is to 
provide a uniform and consistent means of allocating, locating, and 
maintaining files on disk. 


On a disk, there are many User File Directories (UFDs) in which files 
are catalogued. A particular UFD is referenced by specifying the 
correct UIC (User Identification Code). The UIC consists of two 
numbers separated by a comma and enclosed in brackets (such as UIC 
{11,20]). The first number (11) is the group_ number; the second 
number (20) is the member number, which indicates a specific directory 
within a group of directories. RSX-11M makes use of the UICS to’ keep 
related files in specific directories. 


F.1.1 Group Number 


The group number is used to identify groups of directories. By 
convention, group numbers of 1 through 10 are reserved for access by 
the Executive. At present, only group number 1 is used. It is used 
to identify UFDs which contain files relevant to an RSX-11M system. 
Group numbers 11-377(8) may be used for user files. Please note, 
however, that group numbers 11-27(8) are reserved by DIGITAL for 
storing files relevant to the Executive and Ancillary Control 
Processors (ACP). 


Group Number 11 is used for Executive files 
12 is used for MCR files 


In addition, group numbers 30-177(8) are reserved for DEC-supplied 
software tasks. The distribution kit only uses group numbers 1, 11, 
12, 13, 15, 45, and 200. 


Group number 15 is used for privileged utility tasks 
(PMD, RMDEMO, etc.) 

Group number 45 is used for K-series files 

Group number 200 is used for SYSGEN indirect command files 


F.1.2 Member Number 


SYSTEM CONVENTIONS 


The second number (member number) is used to hold different file types 
For example, the UIC [11,10] contains source modules of 


of the group. 
the Executive. 


10 
20 


24 


30 


34 


40 


50 
54 
60 
64 
200 


Member numbers 


Member numbers 


50, 


Member numbers currently in use are: 


Source modules. 

Object modules, assembly and task build command 
files, object module libraries, overlay descriptor 
files for the Executive and all unmapped 
privileged and nonprivileged tasks. 

Same as 20 above, except that files are for mapped 
privileged and nonprivileged tasks, and_ the 
Executive. 


Listing and map files for all unmapped privileged 
and nonprivileged tasks. 


Listing and map files for all mapped privileged 
and nonprivileged tasks. 


SLP correction files for files located under 
member number 10. 


Tasks and Executive for RSX-11M unmapped system. 
Tasks and Executive for RSX-11M mapped system. 
Tasks and Executive for RSX-11S unmapped system. 
Tasks and Executive for RSX-11S mapped system. 


SYSGEN indirect command files. 


54, 60, and 64 exist only for group number 1. 


and 40 exist only for group numbers above 10. 


Member numbers 20, 24, 30, and 34 exist for all group numbers. Member 
number 200 is used exclusively with group number 200. 


For example, for MCR: 


[12,10] 


[12,20] 


[12,24] 


[12,30] 
[12,34] 


[12,40] 


Source files. 


Unmapped object modules, assembly command files 
and library build command file. 


Mapped object modules, assembly command files and 
library build command file. 


Unmapped listing files. 
Mapped listing files. 


SLP correction files for files under [12,10]. 


SYSTEM CONVENTIONS 


For the unmapped system: 


{1,20] Object module libraries, task build command files, 
and Task Builder overlay description files for all 
tasks. 

[1,30] Area for task maps. 

[1,50] RSX-11M Executive and system tasks. 


For the mapped system: 


[1,20] Object module libraries, all task build overlay 
descriptor files for all nonprivileged tasks. 


[1,24] Object module libraries, task build command files 
for all mapped tasks, and overlay description 
files for all privileged tasks. 

{1,34] ) Executive and task maps. 


{1,54] RSX-11M Executive and system tasks. 


Other UICs: 


F.2 


[1,1] System and macro object module libraries. 
{1,2] System message files. 

[1,3] Directory for lost files found by VFY. 

[1,4] Directory for Post-Mortem and Snapshot Dumps. 
[1,6] Directory for error log files. 

[1,51] Standalone DSC 


NAMING CONVENTIONS 


System file names have the following general format: 


pppnnnsss.typ 


where: 


PPP 


nnn 


Sss 


is an optional prefix used to designate a special version or 
characteristic of the named file. The designation BIG, for 
example, is sometimes used to designate a task, such as TKB, that 
is built to operate in more than 8K of memory, e.g., BIGTKB. 


is the system identification for the task. Table F-l1 lists all 
system tasks, together with the identification and group codes. 


is a suffix for noting the relationship of the file to the task 
specified in the nnn identification. For example, PIPBLD.CMD is 
the command file for building PIP. 


Suffixes: 
ASM -- Assembly command file 
BLD -- Task Builder command or overlay description file 


@ 


SYSTEM CONVENTIONS 


typ is the standard mnemonic for file type, such as MAP, CMD, etc. 


Types: 
CMD - Command File 
DAT - Data files 
LST - MACRO-11l Listing File 
MAC - MACRO-11 Source File 
MAP - Task Map File 
MLB -- User Macro Library File 
OBJ - MACRO-11 Object Library File 
ODL - Overlay Description File 
OLB - Object Library File 
PMD - Post-Mortem or Snapshot Dump File 
SML - System Macro Library File 
STB - Task Symbol Table File 
TSK - Task/Driver Image File 
Table F-1 
System Identification Codes 
System Group 
ID Code Description 
RSX A RSX-11M/S Executive, drivers, and tables 
MCR 12 Monitor Console Routines 
FCP 13 Files-1l1 Ancillary Control Processor (ACP) 
RMD 14 RMDEMO 
PMD 15 Post-Mortem and Snap-Dump Processor 
BMR 16 Basic MCR (RSX-11S) 
ERL 17 Error Logger 
OTL 20 On-Line Task Loader (RSX-11S) 
SIP 21 System Image Preservation Program (RSX-11S) 
MTA 22 Magtape ACP 
QMG 25 Queue Manager 
MAC 30 MACRO-11 Assembler 
TKB 31 Task Builder 
PIP 32 Peripheral Interchange Program 
FLX 33 File Transfer Program 
VFY 34 File Structure Verification Program 
DMP 35 File Dump Utility 


(continued on next page) 
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Table F-1 (Cont.) 


System Identification Codes Canina 

System Group 

ID Code Description 

DSC Disk Save and Compress Utility (task version) ; 
EDI Line Text Editor 

SLP Source Language Input Program 7 
PRESRV Volume Preservation Program 

LBR Librarian 

PRT Serial De-spooler 

ODT,TRACE Online debugging tool, trace a, 
FCS File Control Services : 
PSE,SYE Error log formatters 

CML Command Line Routing 

ZAP File Patch Utility Program 

BAD Bad Block Locator Program 

DSCcs8 Disk Save and Compress Utility (stand-alone 

version) 

CRF Cross Reference Utility Program 

VMR Virtual MCR Program 

BRU Backup/Restore Utility 

UMD User Mode Diagnostics 

FTB Fast Task Builder am, 
CMP File Compare Utility 

PAT Object Module Patch Utility 

FMT Online Formatter 

IOX System I/O Exerciser _ 
CDA Crash Dump Analyzer ; 
LPP Queue Manager De-spooler 


APPENDIX G 


BUILDING A 4K FCS RESIDENT LIBRARY 


This Appendix documents the method to build a 4K FCS resident library 
(FCSRES). 
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BUILDING A 4K FCS RESIDENT LIBRARY 


eTITLE FCSRES = FCS RESIDENT LIBRARY FILE 
eIDENT /17,08/ 


COPYRIGHT 1974, DIGITAL EQUIPMENT CORP,, MAYNARD, MASS, 


THIS SOFTWARE IS FURNISHED TO PURCHASER UNDER A LICENSE FOR USE 
ON A SINGLE COMPUTER SYSTEM AND CAN BE COPIED (WITH INCLUSION 
OF DEC*S COPYRIGHT NOTICE) ONLY FOR USE IN SUCH SYSTEM, EXCEPT 
AS MAY OTHERWISE BE PROVIDED IN WRITING BY DEC, 


THE INFORMATION - IN THIS DOCUMENT IS SUBJECT TO CHANGE WITHOUT 
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL 
EQUIPMENT CORPORATION, 


DEC ASSUMES NO RESPONSIBILITY FOR TRE USE OR RELIABILITY 
OF JTS SOFTWARE ON EQUIPMENT WHICH JS NOT SUPPLIED By DEC, 


MODIFIED? 


SR417 = COMMENT OUT ENTRY POINTS, TO RESTORE DEFAULT 
FCSRES TO BELOW 4k, 

SRBiIB = INSERT CALLS OF ARITH AND DARITH ROUTINES TO 
CORRECT PSECT PROBLEM, 


THIS FILE DOCUMENTS HOW TO BUILD AN FCS RESIVENT LIBRARY, 
AND IT DEFINES ALL OF THE POSSIBLE MODULES THAT MIGHT GO INTO 
SUCH A LIBRARY, 


IT SHOULD BE UNDERSTOOD THAT PRECISELY HOW MUCH GOES INTO FCSRES 

IS ACTUALLY DEPENDENT ON WHICH PROGRAMS ARE GOING TO USE IT AND WHAT 
THOSE PROGRAMS REQUIRE, THE IMPORTANT POINT TO BEAR IN MIND 

IS THAT A PROGRAM LINKING TQ FCSRES MAY NOT GET MISSING FCS MODULES 
FROM THE SYSLIB,OLB OBJECT LIBRARY FILE AS WELL, A PROGRAM NEEDING 
FCS MODULES WHICH WERE NOT PLACED IN FCSRES WOULD HAVE NO CHOICE 

BUT TO LINK WITHOUT FCSRES AND USE ALL THE MUDULES OUT OF SYSLIB. 


FUR THE OBVIOUS REASONS OF SIZEe THE MINIMUM AMOUNT SHOULD BE PUT IN 
FCSRES CONSISTENT WITH THE NEEOS OF THE PROGKAMS USING IT, 


THOSE ENTRY POINTS THAT ARE INVOKED BY MACROS ARE DOCUMENTED BELOW 
SO THAT IT IS POSSIBLE TO PICK WHAT SHOULD GU INTO FCSRES, 


It Is INTENDED THAT THIS FILE BE EDITED TO ELIMINATE UNDESIRED 
MODULES FROM FCSRES. 


THE ACTUAL BUILDING OF FCSRES INVOLVES THE FOLLOWINGS 
1) ASSEMBLE THIS MODULE 


MAC> FCSRES-/FCSRESSFCSRES 
2) BUILD THE LIBRARY 
SET /UICs(1,1] 
TO BUILD FCSRES FOR A MAPPED SYSTEMS 


TKB> (1,1) FCSRES/@HD/MM/PI, LPS, SY8 (1,1) FCSRES* (200,200) FCSRES 
TKB>/ 

TKB>STACKS@ 

TKB>PARSFCSRES 10120000 

TKB// 


TO BUILD AN FCSRES ON AN UNMAPPED SYSTEMS 


TKB>SY8 (i, 1] FCSRES/@HD/@MM/PI,LPs,SYs (1,1) FCSRES® (200,200) FCSRES 
TKB>/ 

TKB>STACKS@ 

TKB>PAREFCSRESs 1 40AnURs eeR00 

TKB>// 


TY 


oMCALL 
oPSECT 


3 
+ OPENING FILES 
3 


eGLOBL 
eOPFTOSeCALLR 
eGLOBL 


$ 
: CLOSING FILES 
»GLOBL 


; 
3 RECORD I/0 
’ 

eSLOBL 
ePUTSQOSSCALLR 
eGETSQesCALLR 


BUILDING A 4K FCS RESIDENT LIBRARY 


CALLR 
$$RESL 


2 OPEN 
OPEN 
~OPFNB 


o CLOSE 


eGET, ePUT 
ePUT 
oGET 


sOPENSX, OPNSSX, OPNTSX 
sOFID$X CAN USE THE OPENSX CODE 
;OFNBSX » USED FOR FORTAN RUN TIME 


sCLOSES$ 


+GET$, AND PUTS, GETSR, AND PUTSR 
sPUT$S CAN USE PUTS CODE 
rGET$S CAN USE GETS CODE 


’ 
3 ARITH AND DARITH ROUTINES NECESSARY FOR GETS AND PUTS 


; 
eGLOBL 


3 BILOCK 1/0 
eGLOBL 
9 DELETE FILES 


eGLOBL 
eGLOBL 


+ FILE EXTENSION 


oGLOBL 


$DIV,SOMUL,SDDIV 3 


eREAD,, WRITE,,WAIT yREADS, WRITES, AND WAITS 


eOELET 
eMRKDL 


eEXTND 


3 DIRECTORY OPERATIONS 


»GLOBL 


sDELETS 
,USED BY OPNTS$U 


oF IND, eENTER, eREMOV 


$ FILE POSITIONING 


oGLOBL 


ePOINT, » MARK 


y ESTABLISH DIRECTORY ID 


eGLOBL 


eGTDI0, eGTOIR 


y READ AND WRITE FILE STORAGE REGION CELLS 


eGLOBL 


eSLOBL 
RENAME FILE 

oGLOBL 
ISSUE GENERAL 

eGLOBL 
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e END 


eROFOR, ,WOFDR, gRFOWN, -WROWN, -ROFFP, ,WOFFP 


eDLFNB 


eRENAM 


THE FOLLOWING MODULES HAVE BEEN COMMENTED OUT TO REDUCE THE SIZE OF 
THE DEFAULT FCSRES TO BELOW 4u97, 
YUU REMOVE OTHER ,GLOBL STATEMENTS, 


YOU MAY RESTORE THEM, BUT ONLY IF 


THE FOLLOWING MODULE Is NORMALLY NOT USED, DELETS Is MUCH MORE COMMON 


DELETE BY FILE NAME BLOCK 


GIO AND SPECIAL MAGTAPE FUNCTION QI/OS 


eXQOT0,, CTRL 


APPENDIX H 


HELP TEXT FILES 


Each distribution kit includes a file (HELP.ULB) which consists of 


‘text sources for the MCR Help command. 


For Big Disk kits, HELP.ULB can be found under the UFD [1,2]. 


For Dual 
(EXCSRC) 


For RLO1l 
(RLUTIL) 


RKO5 kits, HELP.ULB is contained on the Executive source disk 
under the UFD [1,2]. 


kits, HELP.ULB is contained on the utility source disk 
under the UFD [1,2]. 


The following lists the steps to use the Help support from HELP.ULB: 


l. 


2. 


Log on privileged 


Assign the default system device SY: to the pseudo device 
LB:. For example: 


>ASN LB:=SY: 


Establish [1,2] as the default UIC for the terminal. For 
example: 


>SET /UIC=[1,2] 
Mount the volume that contains HELP.ULB. For example: 
>MOU DK1:EXCSRC 


Copy HELP.ULB to the LB: device. For example (continuing 
the DKl: example): 


>PIP /NV=DK1:HELP.ULB 


Extract the build module from HELP.ULB and name the file 
HELPBUILD.CMD. For example: 


>LBR HELPBUILD.CMD=HELP .ULB/EX :BUILD 
Initiate the Help build command file. For example: 
>@HELPBUILD 
The Help build command file (HELPBUILD.CMD) permits you_ to 
build Help support for most of the MCR commands and several 


of the RSX-11M utilities or you can build a skeletal Help 
file. 


HELP TEXT FILES 


8. When the task build completes, you can delete the 
HELPBUILD.CMD and HELP.ULB. For example: 


>PIP HELPBUILD.CMD;*, HELP.ULB;*/DE 
9. Then dismount the volume. For example: 


>DMO DK1: 


files 


wy 


LF 


APPENDIX I 


HARDWARE BOOTSTRAP PROCEDURES 


I.1 HARDWARE BOOTSTRAP ROUTINES 


This section describes the procedures for bootstrapping programs’ into 
PDP-11 processor memory using the following PDP-11 bootstrap Read-Only 


Memory 
e 


Telel 

Follow 
l. 
2. 
3. 
4. 


5. 


6. 


programs: 
The BM792-YB Bootstrap ROM 

The MR11-DB Bootstrap ROM 

The BM873-YA Bootstrap ROM 

The BM873-YB Bootstrap ROM 

The M9301-YA and M9301-YB Bootstrap ROM's 

The M9301-YC Bootstrap ROM (PDP-11/70 processors only) 


The M9301-YF Bootstrap ROM 


RM792-YB Bootstrap ROM 

this procedure to start up the BM792-YB bootstrap ROM: 
Press HALT | 
Set the console switches to 173100. 


Press LOAD ADDRESS. 


Enter the address of the Load device in the console switches: 


Device Code 

RKil Disk 177406 

RF1l Disk 177462 

RPll Disk 176716 

TCl1l DECtape 177344 
Lift the HALT key. 


Press START. 


The system then displays on the console terminal the 
sequence, 


start-up 


HARDWARE BOOTSTRAP PROCEDURES 


I.1.2 MR11-DB Bootstrap ROM 


Br 
Follow this procedure to start up the MR11-DB bootstrap ROM: 
1. Press HALT. 
2. Enter the address of the load device in the console switches: 
Device Code : 
RF1l1 Disk 173100 
RK11 Disk 173110 
TCll DECtape 173120 
TM1l Magtape 173136 a 
RP1l Disk 173154 
3. Press LOAD ADDRESS. 
4. Lift the HALT key. 
5. Press START. 
oa, 
The system then displays on the console terminal the start-up ; 
sequence. 
I.1.3 BM873-YA Bootstrap ROM 
Follow this procedure to start up the BM873-YA bootstrap ROM: 
1. Press HALT. 
am, 
2. Enter the address of the load device in the console switches: 
Device Code 
RF1l DISK 173000 
RK11 DISK 173010 
TCll DECTAPE 173030 
TM11 MAGTAPE 173050 
RP1l DISK 173100 
RCl11l DISK 173144 
KL11/ DL11 173210 mm, 
TAl1 CASSETTE 173230 
PCll PAPERTAPE 173312 
3. Press LOAD ADDRESS. 
4. Lift the HALT key. 
5. Press START. 
The system then displays on the console terminal the start-up . 
sequence. 
% 
a. 


“ ‘ 


HARDWARE BOOTSTRAP PROCEDURES 


I.1.4 BM873-YB Bootstrap ROM 


To start up the BM873-YB bootstrap. ROM, follow this procedure: 


l. Press HALT. 


2. Enter the address of the load device in the console switches: 


Device 
<RH11/RH70/RS03/RS04 Disk (unit 0) 


<RH11/RH70/RS03/RS04 Disk (unit in switch 
register) 


RK11 Disk (unit 0) 

RK11 Disk (unit in switch register) 

TCll DECtape (unit 0) 

TMl1 Magtape (unit 0) 

RF1ll Disk 

RH11/RH70/TMO2/TU16 Magtape (unit 0) 
RH11/RH70 Device Combination (unit zero) 


RH11/RH70 Device Combination (unit in switch 
register) 


RH11/RH70/RP04/RPO5/RP06 Disk (unit 0) 


RH11/RH70/RP04/RP06 Disk (unit in switch 
register.) 


RP11/RP02/RP03 Disk (unit 0) 

RP11/RP02/RP03 Disk (unit in switch register) 
KL11/DL11 Console Terminal Reader 

TA11 Cassette (unit zero) 

TAl11 Cassette (unit in switch register) 


PCll papertape reader 


3. Press LOAD ADDRESS. For units other than Zero, 
number in switch register. 


4. Lift the HALT key. 


5. Press START. 


The system 
sequence. 


Code 


173000 


173002 
173030 
173032 
173070 
173110 
173136 
173150 


173230 


173232 


173320 


173322 
173350 
173352 
173510 
173524 
173526 
173620 


enter unit 


then displays on the console terminal the start-up 
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I.1.5 M9301-YA or M9301-YB Bootstrap ROM 


Follow this procedure to start up either the M9301-YA or the M9301-YB 
bootstrap ROM: 


1. Press the BOOT switch. 


2. In response to the $ prompt on the console terminal, enter 
one of the following 2-letter codes: 


Code Device 

DB RPO4 05/06 DISK M9301-YB ONLY 

DK RK1l DISK 

DP RPll (RPO2/03) DISK 

DS RSO03/04 DISK M9301-YB ONLY 

DT TCl1l DECTAPE 

DX RXl1l1 FLOPPY DISK 

CT TA11 CASSETTE TAPE 

MC MIXED MASSBUS DEVICE M9301-YB ONLY 
MM TMO02/TU16/TU45 MAGTAPE M9301-YB ONLY 
MT TM11/TMA11/TMB11/TU10 MAGTAPE 

PR PC11/PR11 PAPER TAPE READER 

TT KL11/DL11 CONSOLE TERMINAL READER 


The two alphabetic characters may be followed by an optional 
single octal digit for bootstrapping from units other than 
zero, and terminated by a carriage return. 


The system then displays on the console terminal the start-up 
sequence. 


I.1.6 M9301-YC Bootstrap (PDP-11/70 Only) 


The M9301-YC bootstrap operates only on the PDP-11/70. Perform the 
following steps to use this bootstrap. 


l. Press the HALT switch and set back to the enable position. 
2. Set the START address of 17765000 in the console switches. 


3. Press LOAD ADDRESS. 


4. Set the device unit number in switches 0 through 2. 


5. Set the device code in switches 3 through 6. The device 
codes are: 
Code Device 
1 TM11/TU10/TSO3 MAGNETIC TAPE 
Z TC11/TU56 DECTAPE 
3 RK11/RKO05 DECPACK DISK CARTRIDGE 
4 RP11/RP02/RP03 DISK PACK 
6 RH70/TU16/TU45 MAGNETIC TAPE 
7 RH70/RP04/RPO5/RPO06 DISK PACK 
10 RH70/RS04/RS03 FIXED HEAD DISK 


6. Ensure that switches 7 through 21 are off (down). 


7. jPress START, 
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The system then displays on the console terminal the start-up 
sequence. 


Before the M9301-YC bootstrap actually boots the system, it performs 
CPU tests, instruction and addressing tests, and memory and cache 
tests. If a hardware failure is detected, and diagnostic program 
halts. The lights contain the ROM address of the HALT. If this 
occurs, call the Digital Field Service Engineer. 


It may, however, be possible to continue with the bootstrap operation 
if the lights contain the address 17773764, which indicates a cache 
failure. To continue in this case, press cont. This is the only case 
in which it is possible to continue bootstrapping after the diagnostic 
detects an error. 


I.1.7 M9301-YF Bootstrap ROM 


The following instructions bootstrap the system by means of the 
M9301-YF console emulator. Refer to the M9301 Bootstrap/Terminator 
Maintenance Manual, for other ways to boot the system with the 
M9301-YF. 


Follow this procedure at the operator's terminal: 
1. Press the console BOOT switch. 


If diagnostics are enabled, the M9301-YF performs’ primary 
CPU diagnostics. 


The terminal then displays the contents of RO, R4, SP, and 
R5, respectively; the contents appear as four 16-bit octal 
numbers. Note that pressing the boot switch at this time 
causes PDP-1ll systems without console registers to copy the 
PC into R5 before the power-up sequence begins. 


The terminal then displays the prompt $ at the beginning of a 
new line. 


2. In response to the prompt $, type the appropriate device code 
at the terminal, followed by carriage return: 


Code Device 

DBN RPO04, RPOS, RPO6, DISK 
DKN RKO5 DISK 

DMN RKO6 DISK 

DSN RSO3 OR RSO4 DISK 

DTN TU56 DECTAPE 

DXN RX01 FLOPPY DISK 

MMN TU16 MAGNETIC TAPE 

MTN TU10O MAGNETIC TAPE 

PR PCll PAPER TAPE READER 
TT DL11 CONSOLE TERMINAL READER 


1 The M9301-YF micro switches must be set to 000 to perform 
diagnostics when using the console emulator to boot the system. If 
the switches are set to 002, the M9301-YF console emulator boots’ the 
system without performing diagnostics. Consult a Digital Field 


Service Engineer or see the M9301 Bootstrap/Terminator Maintenance 
Manual. 
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In the list of codes above, n represents the device unit 
number; the only permissible values are 0 through 7. The 
unit number can be omitted if it is 0. 


If diagnostics are enabled, the M9301-YF performs secondary 
CPU and memory diagnostics before booting the system. 


The system then displays on the console terminal the start-up 
sequence. 
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READER'S COMMENTS 


NOTE: This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company's 
discretion. If you require a written reply and are 
eligible to receive one under Software Performance 
Report (SPR) service, submit your comments on an SPR 
form. 


Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 


Did you find errors in this manual? If so, specify the error and the 
page number. 


Please indicate the type of reader that you most nearly represent. 


Assembly language programmer 
Higher-level language programmer 
Occasional programmer (experienced) 
User with little programming experience 
Student programmer 
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Name Date 
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